# Keyboard shortcuts and the command palette

Every keyboard shortcut in the dashboard, the shortcuts panel that lists the keys for the page you're on, and the command palette for going to pages and running commands

You can work in the dashboard from the keyboard: go to a page, act on a ticket, edit and save. Two tools help:

- The **shortcuts panel** lists the keys that work on the page you're on.
- The **command palette** finds any page, setting or command by name, and runs it.

On a Mac the shortcuts use `⌘`. On Windows and Linux they use `Ctrl` instead.

## Open the shortcuts panel

1. **Open the Help menu**

   Click **Help** at the bottom of the sidebar, or press `?`.

2. **Click Keyboard shortcuts**

   You can also press `⌘/` (`Ctrl+/` on Windows and Linux) from any page.

   *Product example: The Help menu open at the bottom of the sidebar: Docs, Status page and API reference, then Keyboard shortcuts with its key (ringed).*

The **Keyboard shortcuts** panel opens on the right. It lists only the keys that work where you are: first the commands for what's on the page, each under its own heading, such as **Ticket**, then the keys under **Everywhere**. A command that doesn't apply right now, such as **Resolve ticket** on a resolved ticket, isn't listed.

*Product example: The Keyboard shortcuts panel over ticket IT-142: the ticket's copy and ticket commands, the Assistant keys, and the keys that work everywhere.*

While the panel is open, the page's own keys don't run. Use the arrow keys, `Page Up`, `Page Down`, `Home` and `End` to scroll the list. Press `⌘/` again, `Esc`, or click **×** to close it.

## How the keys work

- A key that is a single letter or symbol, such as `e` or `/`, doesn't work while you type in a text field. A key with `⌘`, `Ctrl` or `Alt`, such as `⌘S`, works there too.
- Letters are the key as you press it, without `Shift`: `e`, not `E`.
- `g` then `i` means: press `g`, let go, then press `i`.
- A key runs its command only where the command applies and you have permission for it. Otherwise it does nothing.

## Shortcut reference

### Everywhere

| Action                         | Mac          | Windows and Linux |
| ------------------------------ | ------------ | ----------------- |
| Open the command palette       | `⌘K`         | `Ctrl+K`          |
| Show keyboard shortcuts        | `⌘/`         | `Ctrl+/`          |
| Open the Help menu             | `?`          | `?`               |
| Collapse or expand the sidebar | `[` or `⌘B`  | `[` or `Ctrl+B`   |
| Go to **Inbox**                | `g` then `i` | `g` then `i`      |
| Go to **Tickets › All**        | `g` then `t` | `g` then `t`      |
| Go to **Settings**             | `g` then `s` | `g` then `s`      |

**Inbox** and **Tickets › All** work when you are an Agent or a Supervisor in a department. **Settings** works when you can see Settings in the sidebar. See [Dashboard overview](https://www.tryrisotto.com/docs/dashboard/overview).

### Assistant

For Org Admins, Managers, and department Supervisors. See [Assistant](https://www.tryrisotto.com/docs/dashboard/assistant).

| Action                                                    | Mac   | Windows and Linux |
| --------------------------------------------------------- | ----- | ----------------- |
| Open or close the Assistant panel                         | `⌘J`  | `Ctrl+J`          |
| Start a new Assistant conversation                        | `⇧⌘O` | `Ctrl+Shift+O`    |
| Put the cursor in the message box of an open conversation | `/`   | `/`               |

`⌘J` doesn't work on the **Assistant** page and in the script studio, which have their own conversation instead of the panel. `/` doesn't work on settings pages, where it searches settings.

### A ticket

On a ticket's page, and on the ticket you selected in the **Inbox**:

| Action                | Mac   | Windows and Linux |
| --------------------- | ----- | ----------------- |
| **Copy ticket ID**    | `⌘.`  | `Ctrl+.`          |
| **Copy link**         | `⇧⌘,` | `Ctrl+Shift+,`    |
| **Escalate ticket…**  | `e`   | `e`               |
| **Reprocess ticket…** | `r`   | `r`               |
| **Resolve ticket**    | `d`   | `d`               |
| **Change status…**    | `s`   | `s`               |
| **Assign to me**      | `i`   | `i`               |
| **Assign to…**        | `a`   | `a`               |

On a ticket's page, `j` opens the next ticket and `k` the previous one in the list you opened it from.

Copy works for anyone who can see the ticket. The other commands need you to be an Agent or a Supervisor of the ticket's department, and some apply only to some tickets. For example, **Escalate ticket…** and **Reprocess ticket…** don't apply while the ticket waits for an approval. See [Ticket commands](https://www.tryrisotto.com/docs/dashboard/tickets/all#ticket-commands).

### Inbox

| Action                          | Mac                    | Windows and Linux           |
| ------------------------------- | ---------------------- | --------------------------- |
| Select the next ticket          | `j` or `↓`             | `j` or `↓`                  |
| Select the previous ticket      | `k` or `↑`             | `k` or `↑`                  |
| Open the selected ticket's page | `Enter` or `o`         | `Enter` or `o`              |
| Open the selected ticket's menu | `⇧F10` or the menu key | `Shift+F10` or the menu key |

The ticket keys above also work on the selected ticket. See [Inbox keyboard shortcuts](https://www.tryrisotto.com/docs/dashboard/tickets/inbox#keyboard-shortcuts).

### Tables

In tables, such as **Tickets › All**, press `Tab` until a row is focused, then:

| Action                             | Key                     |
| ---------------------------------- | ----------------------- |
| Move to the next or previous row   | `↓` or `j`, `↑` or `k`  |
| Move to the first or last row      | `Home`, `End`           |
| Move through the buttons in a row  | `→`, `←`                |
| Open the row                       | `Enter`                 |
| Select or clear the row's checkbox | `Space` or `x`          |
| Select rows as you move            | `Shift` with `↓` or `↑` |
| Clear the selection                | `Esc`                   |

Selection works in tables that have checkboxes, such as the ticket tables and **Views**. See [Bulk updates](https://www.tryrisotto.com/docs/dashboard/tickets/all#bulk-updates).

### Editing

On the page of an article, a runbook, a tool, an access rule or an automation:

| Action         | Mac   | Windows and Linux |
| -------------- | ----- | ----------------- |
| Edit           | `e`   | `e`               |
| Save           | `⌘S`  | `Ctrl+S`          |
| Cancel editing | `Esc` | `Esc`             |

`e` opens the editor, like **Edit** on the page. It doesn't work while you're already editing, or on an access rule synced from a Google Group. On a runbook or an automation, it works only when you can edit it. `⌘S` saves articles, runbooks and automations. To save a tool or an access rule, click **Save**.

### Settings

On settings pages, press `/` to search the settings.

## The command palette

The command palette finds pages, settings and commands by name, and runs them.

1. **Open the command palette**

   Press `⌘K` (`Ctrl+K` on Windows and Linux), or click the search icon next
   to your organization's name at the top of the sidebar.

2. **Type what you're looking for**

   For example, type "status" or "integrations". The list narrows as you
   type. Use `↑` and `↓` to move through it.

   *Product example: The command palette over ticket IT-142, scoped to the ticket, with Ask the Assistant on Tab and the ticket's commands first; Change status is ringed.*

3. **Run the command**

   Press `Enter` or click it. A command that ends in **…** opens a second
   list, such as the statuses for **Change status…**, or a text box, such as
   the new title for **Rename ticket…**. Choose an option or type, and press
   `Enter`.

   *Product example: The command palette on Change status for IT-142: the statuses numbered 1 to 8, with In progress checked.*

In a numbered list, such as **Change status…** or **Set priority…**, press the option's number to pick it at once, before you type anything. Press `Backspace` in the empty search box to go back to the first list. Press `Esc` to close the palette.

When the palette acts on something, its name shows above the search box: a ticket, such as **IT-142 · VPN keeps disconnecting**, or a selection, such as **3 tickets**. A command's shortcut shows at the end of its row.

You can also open the palette from:

- **Actions** in the bar that shows when you select tickets. See [Bulk updates](https://www.tryrisotto.com/docs/dashboard/tickets/all#bulk-updates).
- **Other…** in a ticket's right-click menu, under **Assign to…**, for the full list of people.

### Ask the Assistant

If you can use the Assistant, type a question and press `Tab`, or choose **Ask the Assistant:** followed by your text. The palette closes and your text goes to the Assistant's message box: in a new conversation in the Assistant panel, or in the conversation on the **Assistant** page. Review it and send it. See [Assistant](https://www.tryrisotto.com/docs/dashboard/assistant).

### What the palette lists

The palette lists the commands for what's on the page first, then these groups:

- **General**: **Open Help menu** and **Show keyboard shortcuts**.
- **View**: **Toggle sidebar**.
- **Appearance**: **Use light theme**, **Use dark theme**, **Use system theme**, **Toggle theme**, and **Toggle colorblind-friendly colors**. See [Theme](https://www.tryrisotto.com/docs/dashboard/account-settings#theme).
- **Go to**: every page in the sidebar that you can see, such as **Go to Inbox** and **Go to Tickets › All**, your saved ticket views, the **Settings** and **Developers** pages you can open (**Go to Settings › Integrations**, **Go to Developers › API keys**), and the Help menu's links. It also has pages that aren't in the sidebar: **Go to Knowledge › Indexes**, **Go to Knowledge › Playground**, and, for Org Admins and Managers, **Go to API reference › Redoc**.

When you type, the palette also finds each department's settings pages, each integration's page for Org Admins and Managers, and individual settings. A setting's row shows where it is, and choosing it opens that settings page. When there is more to find, the empty palette says "Type to find more pages." under the list.

The commands for what's on the page:

| Where                                              | Commands                                                                                                                                                                                         |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| A ticket's page, or a ticket selected in the Inbox | The ticket's commands. See [Ticket commands](https://www.tryrisotto.com/docs/dashboard/tickets/all#ticket-commands). On a ticket's page, also **Next ticket** and **Previous ticket**.           |
| The Inbox                                          | **Next ticket**, **Previous ticket**, and **Open ticket**                                                                                                                                        |
| Selected tickets in a ticket table                 | **Resolve N tickets**, **Change status of N tickets…**, **Assign N tickets to…**, **Delete N tickets…**. See [Bulk updates](https://www.tryrisotto.com/docs/dashboard/tickets/all#bulk-updates). |
| A saved view you own                               | **Rename view…**, **Share view with organization** or **Stop sharing view**, **Delete view…**                                                                                                    |
| Views you own, selected in **Views**               | **Share N views with organization**, **Stop sharing N views**, **Delete N views…**                                                                                                               |
| An article                                         | **Edit article**, and **Save** while you edit it                                                                                                                                                 |
| A runbook's page                                   | **Edit runbook**, **Test runbook match…**, **Duplicate runbook**, **Disable runbook** or **Enable runbook**, **Delete runbook…**, and **Save** while you edit it                                 |
| A tool's page                                      | **Edit tool**, **Run tool…**, **Disable tool** or **Enable tool**, **Delete tool…**                                                                                                              |
| An access rule's page                              | **Edit access rule**, **Disable rule** or **Enable rule**, **Duplicate rule**, **Delete rule…**                                                                                                  |
| An automation's page                               | **Edit automation**, and **Save** while you edit it                                                                                                                                              |
| Any page, if you can use the Assistant             | **Open the Assistant** or **Close the Assistant**, and **New Assistant conversation**                                                                                                            |

The runbook commands are also in the right-click menu and the **⋯** menu of a runbook's row in **Runbooks**. The access rule commands are in the **⋯** menu of a row in the access rules table. See [Runbook commands](https://www.tryrisotto.com/docs/dashboard/runbooks#runbook-commands).

A command shows only when you can use it. The runbook commands need you to be an Org Admin, a Manager, or a Supervisor of the runbook's department. **Test runbook match…** shows only for a runbook with a **Request match** condition, and **Enable runbook** does not show while the runbook uses a disabled tool. **Run tool…** shows for an enabled tool that you can edit. **Disable tool**, **Enable tool**, **Delete tool…** and the access rule commands need the Org Admin or Manager role. The access rule commands do not show for a rule synced from a Google Group, and **Disable rule** and **Enable rule** do not show while you edit the rule.

A few keys have no row in the palette: opening the palette, **Cancel editing**, searching settings, moving to the Assistant's message box, and opening the Inbox ticket menu. The shortcuts panel lists them.

Source: https://www.tryrisotto.com/docs/dashboard/keyboard-shortcuts
