# Keyboard shortcuts and command palette

URL: https://testmode.ai/docs/keyboard-shortcuts/

> Testmode keyboard shortcuts: the command palette, Run test, the sidebar toggle, G-then navigation, and create and search keys on list pages.

Testmode has keyboard shortcuts for the command palette, starting a run, the sidebar, moving between pages, and creating or searching on list pages. Press `?` on any page to see the full list.

On Mac, shortcuts use `Cmd`. On Windows and Linux, they use `Ctrl`.

[Screenshot: Keyboard shortcuts dialog with Global shortcuts, Navigation shortcuts pressed as G then a letter, and Page shortcuts. Caption: Press ? to see every keyboard shortcut.]

## Open the command palette

Press `Cmd+K` on Mac or `Ctrl+K` on Windows and Linux. Type to filter the list, then use the arrow keys and `Enter`, or click an item. Press the shortcut again, or `Esc`, to close it.

| Group | Item | Shortcut | What it does |
| --- | --- | --- | --- |
| **Actions** | **Run test** | `Cmd+R` | Opens the **Run tests** dialog. Shown only to the Editor role and above, while a project is selected. |
| | **Start exploration** | None | Opens **New exploration** on the **Explore** page. Shown only to the Editor role and above, while a project is selected. |
| | **Keyboard shortcuts** | `?` | Opens the **Keyboard shortcuts** dialog. |
| **Navigation** | **Overview**, **Assistant**, **Explore**, **Test Cases**, **Test Plans**, **Runs**, **Settings** | G then a key | Goes to that page. |
| **Settings** | **Profile** | None | Opens your profile. |
| | **Organization Settings** | None | Opens **Organization Settings**. Only Owners and Admins can open it; anyone else lands on **Overview**. |

Good to know:

- The palette finds commands and pages only. Despite its "Type a command or search..." placeholder, it does not search your test cases, test plans or runs. Use the search box on each list page for that.
- The palette opens even while you are typing in a field.
- Viewers don't see **Run test** or **Start exploration** in the palette, because they can't start runs or explorations.

## Global shortcuts

These work on every page of the app.

| Shortcut | Mac | Windows and Linux | What it does |
| --- | --- | --- | --- |
| **Command palette** | `Cmd+K` | `Ctrl+K` | Opens or closes the command palette. |
| **Run test** | `Cmd+R` | `Ctrl+R` | Opens the **Run tests** dialog. Works only while a project is selected and you have the Editor role or above. |
| **Keyboard shortcuts** | `?` | `?` | Opens the **Keyboard shortcuts** dialog. Press `Esc` to close it. |
| **Toggle sidebar** | `Cmd+B` | `Ctrl+B` | Shows or hides the sidebar. |

Starting a run needs the Editor role or above. See [Run tests](https://testmode.ai/docs/run-tests/).

**Note: Reloading the page**

While a project is selected and you have the Editor role or above, `Cmd+R` and `Ctrl+R` open the **Run tests** dialog instead of reloading the page. To reload, use your browser's reload button, or `F5` on Windows and Linux. For Viewers, and while no project is selected, the keys reload the page as usual.

## Go to a page (G then a key)

Press `G`, let go, then press the second key within 1 second. While Testmode waits for the second key, a small "G then ..." hint appears at the bottom of the screen.

| Keys | Goes to |
| --- | --- |
| `G` then `O` | **Overview** |
| `G` then `A` | **Assistant** |
| `G` then `E` | **Explore** |
| `G` then `T` | **Test Cases** |
| `G` then `P` | **Test Plans** |
| `G` then `R` | **Runs** |
| `G` then `S` | **Settings** |

- Press `G` on its own, without Shift, `Cmd` or `Ctrl`.
- Pressing `G` again restarts the wait. Any other key cancels the sequence.

## Page shortcuts

These work only on the pages listed.

| Key | Shortcut | Where it works |
| --- | --- | --- |
| `C` | **Create new** | On **Test Cases**, opens **Create Test Case**. On **Test Plans**, opens **Create Test Plan**. On **Explore**, opens **New exploration**. Works only for the Editor role and above. |
| `/` | **Focus search** | Puts the cursor in the search box on **Runs**, **Test Cases**, **Test Plans** and **Explore**. |

On any other page, `C` and `/` do nothing. For Viewers, `C` does nothing on any page, while `/` still works.

## Keys inside pages and dialogs

A few places in the app have keys of their own.

| Where | Keys | What they do |
| --- | --- | --- |
| Screenshot viewer on a run | `Left` and `Right` | Move to the previous or next screenshot. |
| Screenshot viewer on a run | `Esc` | Closes the viewer. |
| **Assistant** message box | `Enter` | Sends the message. |
| **Assistant** message box | `Shift+Enter` | Starts a new line. |
| **Tags** in the test case dialog | `Enter` | Adds the tag you typed. |
| **Recent runs** on **Overview** | `Enter` | Opens the run that has focus. |

## When shortcuts do not fire

- **You are typing in a field.** G sequences, `?`, `C` and `/` are ignored while the cursor is in a text field. Click outside the field first.
- **A dialog or menu is open.** The same keys are ignored while any dialog or menu is open, including the test case dialog, the command palette and the **Keyboard shortcuts** dialog. Press `Esc` to close it first.
- **You are on another page.** `C` and `/` only work on the pages listed under [Page shortcuts](https://testmode.ai/docs/keyboard-shortcuts/#page-shortcuts).
- **No project is selected.** `Cmd+R` and `Ctrl+R` leave the browser to reload the page as usual.
- **You are a Viewer.** `Cmd+R` and `Ctrl+R` reload the page, and `C` does nothing. See [Roles and permissions](https://testmode.ai/docs/roles-and-permissions/).

The **Command palette**, **Run test** and **Toggle sidebar** shortcuts work even while you type or while a dialog is open.

## Related

- [Product tour](https://testmode.ai/docs/product-tour/): Where each page lives and what it is for.
- [Run tests](https://testmode.ai/docs/run-tests/): What happens after you open the Run tests dialog.
- [Read run results](https://testmode.ai/docs/read-run-results/): Step through screenshots with the arrow keys.