Search and the command palette
The command palette opens pages, records, and commands from one box. Press
Ctrl+K, or select the search box in the top bar. The palette also searches
your records. This page shows both uses.
The command palette
Section titled “The command palette”1. Open the palette
Section titled “1. Open the palette”Press Ctrl+K. On macOS, press Cmd+K. You can also select the search box in
the top bar.
The palette shows up to four groups: Navigate, Recent, Records, and Actions. A group with no items stays hidden.
2. Jump to a page
Section titled “2. Jump to a page”Type the name of a domain or a doctype. The Navigate group lists the matches. Select one to open the page.
The Recent group lists the records you opened recently in the current domain.
3. Search for records
Section titled “3. Search for records”Type at least two characters, for example inv. The Records group lists
the matching records. Each result shows the record name. Select a result to
open the record.
Some records are parts of a parent record. A match on a part shows the parent name, with the part that matched below it. Selecting it opens the parent record.
4. Run a command
Section titled “4. Run a command”The Actions group lists commands. Examples: open Builder, open Configure, show the keyboard shortcuts, collapse the sidebar. Commands follow the same rights as the sidebar. A command your role does not allow does not appear.
Move with ↑ and ↓. Press Enter to run the selected item.
Document search
Section titled “Document search”1. Type your term
Section titled “1. Type your term”Search starts at two characters. Type two or more letters, for example ada.
2. Read the results
Section titled “2. Read the results”Search matches part of a word. The term ada matches “Ada Lovelace”. Search
ignores letter case and accents.
The closest matches come first. The palette groups the results by doctype. Search returns at most 25 records, and at most 5 records per doctype.
Results show record names. They do not show field values.
3. Widen or narrow the scope
Section titled “3. Widen or narrow the scope”Search covers the current domain. Use Search all domains for … to search every domain you may read. This option is always present, also when the current domain has no match — it is the way to find a record that lives in another domain.
What search reads
Section titled “What search reads”- A doctype appears in search only when its definition defines searchable text. The text usually holds the record name and key fields. Doctype authors set this text in the doctype definition.
- You see only records your role may read.
- Deleted records never appear.
The search box on a list page is a filter, not this search. It narrows the current list. It matches the searchable text, the record name, and the record id. See Lists, filters and views.
Troubleshooting
Section titled “Troubleshooting”Search returns no records
Section titled “Search returns no records”- Check the term. Search needs two characters or more.
- Check the doctype. It may define no searchable text, so it never appears here.
- Check your rights. Your role may not read the doctype.
- Check the record. It may live in another domain, or it may be deleted.
The palette shows No results for … when nothing matches.
The Records group is missing
Section titled “The Records group is missing”Type at least two characters. If the search request fails, the palette hides the Records group. The other groups stay usable.
A command is missing from Actions
Section titled “A command is missing from Actions”Commands follow your rights. In Configure, the palette lists Configure sections instead of workspace commands.
The top bar has no search box
Section titled “The top bar has no search box”Builder mode has none. Press Ctrl+K.
Related
Section titled “Related”- Keyboard shortcuts — every key combination, including
Ctrl+K. - Lists, filters and views — the search box that filters one list.
- Viewing and editing a document — what opens when you select a result.
- The dashboard — shows the same recently opened records.
- Domains and isolation — why search starts inside your current domain.
- Documents, doctypes and projections — where record names and searchable text come from.