Everyday workflows
Workspaces & navigation
Organize connections, query tabs and side-by-side comparisons in a workspace.
Find your way around
The workspace selector at the top switches between saved connections and named workspaces. Explorer is on the left; query, aggregation and Shell tabs occupy the editor area. The bottom status area shows connection information, background jobs and the application version.
The three-line application menu at the top right contains workspace creation, Shell, connection management, Settings, Documentation and Issues & discussions. The latter opens Palryn's GitHub community repository for bug reports and discussion. Drag the Explorer divider to adjust its width.
Create a named workspace
- Choose Application menu → New workspace.
- Name it for a task or environment, such as “Order investigation”.
- Add the saved connections you need and configure their visible namespaces.
- Save the workspace, then select it in the workspace selector.
Each connection appears as a section in Explorer. Tabs from different connections share the workspace's editor groups, while each tab retains its own connection, database and collection. Check the target displayed in the editor or tab tooltip when comparing similarly named collections.
Search the workspace Explorer
A named workspace has one Explorer heading and one Search databases / collections field above all its connections. Search matches database or collection names across the workspace, ignoring case. Matching a database shows its visible collections; matching a collection shows that collection beneath its database. Each connection's configured namespace visibility rules still apply.
Connections with no matches are hidden while searching. Loading, disconnected and failed-metadata sections stay visible so an incomplete listing is not mistaken for an empty result. The replica-set status, Shell, import, create-database and refresh icons sit beside each connection's name. They remain available when a workspace connection is collapsed, and activating an icon does not expand or collapse it. Direct connection views use the same name-and-actions row beneath the search field. Long names have full-name tooltips; very narrow sidebars wrap the actions as needed.
Searching temporarily opens connection sections to reveal matches. Clear search restores their previous open/closed state and keeps focus in the search field. Database expansion preferences are retained. Each named workspace keeps its own search text; direct connection views have an independent search. Searches are restored with Remember workspace state.
With Follow active tab in Explorer enabled, switching to a tab hidden by the search clears the obstructing workspace search and reveals that tab's connection and collection. Typing a search does not change tabs or run a query.
Limit what Explorer shows
A workspace member can show All namespaces, a selection made with checkboxes, or names matching regular expressions.
- Selecting a database as a whole also includes its future collections. Selecting individual collections makes an explicit list.
- Regex filters are case-sensitive and have no surrounding slashes. A blank expression matches everything.
- Database and collection expressions must both match. The collection expression sees just the collection name.
Database pattern: ^shop$
Collection pattern: ^(orders|customers)$
These settings control Explorer visibility. They do not change MongoDB permissions or add a filter to queries, and they do not close tabs that are already open.
Use tabs and side-by-side groups
By default, single-click selects a collection or view and double-click opens or activates its document-query tab. Change either action under Settings → Explorer. Ctrl+click (Linux/Windows) or Command+click (macOS) always opens a new tab. Reuse matches connection, database and collection across both panes, preferring the active pane and then its most recently used matching tab. Existing filters, edits and results are preserved; opening does not run a query.
Right-click a collection and choose:
- Open to activate a matching document-query tab in either group, preferring the active group, or open one if necessary.
- New tab to start an independent query for the same collection.
- Open to side to use the other editor group for comparison.
- Open aggregation to start a collection-scoped pipeline editor.
Right-click a tab to rename, reorder, duplicate, split, move it to the other group or close other tabs. Duplication copies the draft without executing it. Drag the divider between the two groups to change their widths. Middle-click closes a tab.
Use Shift + F10 or the keyboard's Context Menu key to open menus on focused Explorer items. In a submenu, Right opens it, Left returns, and Escape dismisses the current menu level.
Right-click menus group related actions with separators and use icons for familiar operations. Tab menus group rename/duplicate, movement/splitting and closing. Delete/drop actions are in a final separated group, with their existing confirmation dialogs. Menus adapt to their contents and scroll in short windows.
Switching and restoration
Switching workspaces keeps tabs, drafts and in-memory results. It does not rerun queries. Selecting a connection or workspace connects as needed.
With Remember workspace state enabled, workspace definitions, query drafts, Shell scripts, aggregation drafts and layouts can return after restart. Results remain memory-only, and restored tabs do not run automatically. Read what Remember saves before relying on it for restoration.