# Search and act with the command palette

One box to open any page, find a conversation, customer, document or signal, or run an action.

## Open it

| How | Where |
| --- | --- |
| `⌘ K` on Mac, `Ctrl K` elsewhere | Anywhere in the app. The same keys close it |
| Search button | The magnifier in the top bar. Its tooltip shows the shortcut |

The box reads **Type a command or search**. The assistant has its own sidebar, opened from the Median mark next to the search button. See [Assistant](/articles/ask-the-assistant).

## Browse

With the box empty, the palette lists five groups.

| Group | Rows |
| --- | --- |
| **Go to** | Every page in every tab, named after its tab, like **Settings · Billing** or **Insights · Logs**. Pages your role cannot open are left out |
| **Actions** | **Reach out to a customer**, **New document**, **Add knowledge source**, **Help center**, **Developer docs**, **Share feedback** |
| **Theme** | **Light theme**, **Dark theme**, **System theme**. A check marks the current one |
| **Organization** | One **Switch to** row per other organization you belong to, such as **Switch to Acme**, then **New organization** |
| **Account** | **Manage account**, **Sign out** |

**Reach out to a customer** opens the same dialog as on [Customers](/articles/manage-customer-profiles). **Help center** opens this help center, and **Developer docs** opens docs.median.sh, each in a new tab. **Switch to** changes organization in place. **New organization** opens **Create an organization**, described in [Find your way around the dashboard](/articles/find-your-way-around-the-dashboard#organizations).

## Search

Type to filter the commands and search your organization. Results update when you pause typing.

| Group | Matches | Opens | Rows |
| --- | --- | --- | --- |
| **Commands** | Command labels, plus extra words. `dashboard` finds **Home**, `bugs` finds **Signal · All**, `invite` finds **Settings · Members** | Runs the command | Up to 8 |
| **Conversations** | Subjects and thread ids. Each row shows its thread id | The conversation | Up to 5. Up to 6 when a thread id matches |
| **Customers** | Names and email addresses | The customer's profile | Up to 5 |
| **Knowledge** | Document titles | The document | Up to 5 |
| **Signals** | Titles, descriptions, and the titles of reports merged into a signal | The signal | Up to 5 |

When **Conversations**, **Customers**, **Knowledge** or **Signals** has two or more rows, AI reorders them by relevance, on Standard and Pro. This uses credits. If it fails or takes longer than 1.5 seconds, results keep the search order. **Customers** keeps the search order for a customer number or email search, and **Conversations** keeps it when a thread id matches. See [Plans](/articles/manage-your-plan-and-credits#plans).

With nothing found, the palette says **No results**. If the search itself fails, it says "Search is unavailable. Try again."

### Search syntax

| Type | Finds | Examples |
| --- | --- | --- |
| A letter, an optional dash, and a number | The conversation with that thread id, listed first | `W-12`, `w-12`, `W12` |
| A digit, a dash, and a number | The same, for an organization whose name starts with a digit | `4-7` |
| `#` and a number | The customer with that number | `#12` |
| `customer` and a number | The same | `customer 12`, `customer #12` |
| An email address with no spaces | The customer with exactly that address | `ana@example.com` |

- The letter has to match your organization's thread ids. In an organization whose ids start with W, `C-12` finds nothing by id.
- Bare digits such as `12` are an ordinary search.
- When the search is `#` and a number, starts with `customer` and a space, or contains `@`, **Customers** moves above **Conversations**.
- Thread ids are explained on [Inbox](/articles/work-the-inbox).

## What Enter does

Enter runs the highlighted row. Arrow keys move the highlight, and it wraps around.

| You typed | Highlighted row |
| --- | --- |
| Nothing | The first command |
| Anything else | The first matching command, else the first search result. With nothing found, no row |

## Keys

| Keys | Does |
| --- | --- |
| `⌘ K` or `Ctrl K` | Opens or closes the palette |
| Up and down arrows | Move the highlight |
| `Enter` | Runs the highlighted row |
| `Esc` | Clears the search. With the box empty, closes the palette |
