Reference
Settings & shortcuts
Customize document display, query preferences, tool paths and workspace restoration.
Open Settings
Choose Settings from the top-right application menu. Changes apply immediately and are saved on this device. Sections are arranged in tabs; use Left/Right arrows or Home/End while a tab is focused.
Appearance and document display
- Appearance: UI font size, result font size, row density and BSON type badges.
- Documents: the default Immediate save behaviour, quote markers, natural/alphabetical property order, object summary templates, date format and relative times.
- Value colours: per-BSON-type colour overrides using hex values or preset swatches.
Object summary templates can show the field count and literal top-level fields:
{$fieldCount} fields {Name} ({_id})
Names are case-sensitive. In this template, dots are literal characters rather than nested paths; missing values are omitted. This differs from a relation's dotted display-property path. These presentation settings do not change database values.
Query and notification preferences
Queries selects enabled filter modes, the default for new editors and the maximum result size per query. Keep at least one filter mode enabled. A new result-size limit applies to queries run after the change; each tab keeps its own results in memory.
Notifications sets the toast position and a timeout between 1 and 60 seconds. Hovering or focusing a notification pauses its countdown. Save confirmations are temporary; query/editor status continues to report conflicts or uncertain outcomes.
Configure external tools
Under Tools, set an executable name on PATH or a full executable path, without arguments:
mongoshfor Shell tabs.mongodumpandmongorestorefrom Database Tools 100.3+ for backup and restore.
These tools are installed separately. Document JSON/CSV transfers use Palryn's own implementation and do not need them.
What Remember saves
Workspace → Remember workspace state controls local restoration of workspaces and their drafts. Turning it off clears saved workspace state while retaining the current session in memory.
| Saved with Remember | Not saved in workspace state |
|---|---|
| Workspace names, connection memberships and visibility filters. | Database results and execution errors. |
| Query filters, sort/projection, tabs and layouts. | Unsaved document and insertion drafts. |
| Aggregation drafts, Shell scripts and relation definitions. | Connection credentials, which use the OS keychain separately. |
Workspace storage is local and not encrypted. Query literals and Shell scripts may contain values you entered. On restoration, selecting the active workspace can connect using saved profiles, but queries and scripts require an explicit run.
Updates and release notes
Updates controls automatic update checking. Click the version in the status area to open release information and available update actions. Installation requires choosing Install and restart; checking does not install an update automatically.
With automatic checks enabled, Palryn checks shortly after startup and periodically afterwards, sending its version, operating system and architecture to the update service.
Keyboard reference
| Action | Shortcut |
|---|---|
| Run the current query, pipeline or Shell script from its editor | Ctrl/Command + Enter |
| Request query suggestions | Ctrl/Command + Space |
| Accept a selected query suggestion | Tab |
| Next / previous tab | Ctrl/Command + Alt + Right / Left |
| Close a tab | Ctrl/Command + Alt + W |
| Switch editor group | Ctrl/Command + Alt + Down |
| Open the focused item's context menu | Shift + F10 or Context Menu key |
| Move through menu items | Up / Down, Home / End |
| Enter / leave a submenu | Right / Left |
| Cancel inline value input | Escape |
Reset preferences
Reset display defaults restores display, query, notification and update preferences. It retains workspace state, Immediate save behaviour and tool paths. Backup tool paths have their own reset action in Tools.