Keyboard shortcuts
Every keyboard shortcut wired into Celiq โ global, Discover, Mosaics, and Studio โ plus the in-app shortcuts reference.
When to use it โ Whenever you want to run, save, search, or navigate faster than reaching for the mouse.
Where to find it โ Press ? anywhere, or open your avatar menu (top right) โ Keyboard shortcuts.
Who can use it โ Everyone: Luminary, Weaver, Tracer, and Lens.
Celiq wires keyboard shortcuts directly into the pages where they matter. A few work everywhere; the rest are scoped to a specific surface โ Discover, Mosaics, or Studio โ and only fire while you are on that page. This reference lists exactly what is wired today, so what you read here is what the app does.
Overview
There are four groups of shortcuts:
- Global โ available on every page (toggle this reference, open the command palette, dismiss modals).
- Discover โ run, save, and focus the filter zone while building a query; copy and search inside the results table.
- Mosaics โ re-run every tile, and undo a layout change while editing a mosaic.
- Studio & Notebooks โ run the focused SQL cell.
You can open the in-app Keyboard shortcuts reference at any time by pressing ? (when you are not typing in a text field). It is a quick reminder of the most common keys.
When to use it
Reach for shortcuts when you are doing the same action repeatedly โ running a query while you iterate on filters, saving as you go, copying a value out of a results table, or refreshing a whole mosaic after the underlying data changed. They remove the round-trip to a button and keep your hands on the keyboard.
Concepts
| Term | Meaning |
|---|---|
| Modifier | โ (Command) on macOS or Ctrl on Windows/Linux. Both are accepted everywhere a modifier is shown. |
| Global shortcut | Fires on any page. Listens at the window level. |
| Scoped shortcut | Only active on a specific page (for example, the Mosaics re-run key works only while you are viewing a mosaic). |
| Text-field guard | Most shortcuts deliberately do nothing while your cursor is in an input, textarea, or select, so you can type normally without triggering an action. |
Getting started
No setup is required โ shortcuts are always on. To see the built-in reference:
- Press ? anywhere outside a text field, or
- Click your avatar in the top-right corner and choose Keyboard shortcuts.
Press ? again, click outside the panel, or press Esc to close it.
Step-by-step
Open the shortcuts reference
Press ? on any page (make sure your cursor is not in a text box). The Keyboard Shortcuts panel opens over the current page. You can also reach it from the avatar menu โ Keyboard shortcuts.
Open the command palette
Press โ K (or Ctrl K) to open the command palette and jump to a feature or action by typing.
Run and save in Discover
On a Discover query, press โ Enter to run, โ S to open the save dialog, and โ / to expand and focus the filter zone.
Work the results table
Click a cell in the results table, then press โ C to copy that cell's formatted value. Press โ F to open in-table search.
Refresh and undo in Mosaics
While viewing a mosaic, press R to re-run every tile. While in edit mode, press โ Z to undo your last layout change.
Dismiss anything
Press Esc to close the shortcuts reference, the command palette, table search, fullscreen, or other open panels.
Reference
Global
| Action | macOS | Windows / Linux |
|---|---|---|
| Toggle the keyboard shortcuts reference | ? | ? |
| Open the command palette | โ K | Ctrl K |
| Close the open modal / panel | Esc | Esc |
Discover
| Action | macOS | Windows / Linux |
|---|---|---|
| Run the query | โ Enter | Ctrl Enter |
| Save the query | โ S | Ctrl S |
| Focus the filter zone | โ / | Ctrl / |
| Copy the selected results cell | โ C | Ctrl C |
| Search inside the results table | โ F | Ctrl F |
Mosaics
| Action | macOS | Windows / Linux |
|---|---|---|
| Re-run every tile (viewing a mosaic) | R | R |
| Undo the last layout change (edit mode) | โ Z | Ctrl Z |
Studio & Notebooks
| Action | macOS | Windows / Linux |
|---|---|---|
| Run the focused SQL cell | โ Enter | Ctrl Enter |
Examples
Say you are tuning a Discover query against your orders data. A typical keyboard-only loop:
- Adjust attributes or metrics.
- Press โ Enter to run.
- Press โ / to expand the filter zone and tighten a filter.
- Run again with โ Enter.
- Click the cell you care about and press โ C to copy its value.
- Press โ S to save once it looks right.
In Studio or a Notebook, you can keep the same rhythm. With your cursor in a SQL cell:
select region, sum(revenue) as revenue
from orders
group by region
order by revenue descPress โ Enter (or Ctrl Enter) to run that cell without leaving the editor.
Best practices
- Learn the four you'll use most first: โ Enter (run), โ S (save), โ K (command palette), and ? (this reference).
- Use โ K as your default way to move between features โ it is faster than the navigation menus once it is muscle memory.
- In Mosaics, prefer R over reloading the browser when data has changed; it re-runs the tiles without a full page reload.
Tips
Most shortcuts intentionally ignore key presses while you are typing in an input, textarea, or select โ so ? in a filter box types a question mark instead of opening this reference, and R in a search field types an "r". Click outside the field first if a shortcut isn't firing.
Common mistakes
- Expecting R to work anywhere. It only re-runs tiles while you are viewing a mosaic. It does nothing on other pages, and nothing while you are typing in a field.
- Expecting โ Z to undo data, not layout. In Mosaics it only undoes layout changes, and only while you are in edit mode.
- Expecting โ C to copy the whole table. It copies the value of the single results cell you have selected โ click a cell first.
- Pressing ? with your cursor in a text box. It types a question mark instead of opening the shortcuts reference.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
? types a ? instead of opening the reference | Your cursor is in an input, textarea, or select | Click outside the field, then press ?. Or open it from the avatar menu โ Keyboard shortcuts. |
| R does nothing in a mosaic | You are in the mosaic list view, not viewing a single mosaic; or your cursor is in a text field | Open a mosaic so you are in detail view, click on empty space, then press R. |
| โ R reloads the browser instead of re-running tiles | The re-run shortcut is the plain R key; โ R / Ctrl R is left to the browser on purpose | Press R with no modifier to re-run tiles. |
| โ Z doesn't undo a layout change | You are not in mosaic edit mode, or your cursor is in a text field | Enter edit mode on the mosaic, click outside any field, then press โ Z. |
| โ C copies nothing in the results table | No cell is selected | Click a cell first, then press โ C. |
| โ Enter doesn't run a Notebook/Studio cell | Your cursor is not inside the cell's editor | Click into the SQL cell editor, then press โ Enter. |