Skip to main content
RapidDev - Software Development Agency
retool-tutorial

How to Use Retool's Command Palette

Retool's command palette opens with Cmd+K (Mac) or Ctrl+K (Windows/Linux) and gives you access to 90+ editor actions through a searchable interface. Type any action name — create query, go to component, toggle preview — to find and execute it instantly. It is the fastest way to navigate large apps and access features without hunting through menus.

What you'll learn

  • How to open the command palette with Cmd+K (Mac) or Ctrl+K (Windows/Linux)
  • How to search and execute over 90 editor actions without leaving the keyboard
  • How to quickly navigate to queries, components, and pages in a large app
  • Essential command palette shortcuts that speed up daily Retool development
  • How the command palette differs from Retool's keyboard shortcuts list
Book a free consultation
4.9Clutch rating
600+Happy partners
17+Countries served
190+Team members
Beginner7 min read10 minRetool Cloud and Self-hostedLast updated March 2026RapidDev Engineering Team
TL;DR

Retool's command palette opens with Cmd+K (Mac) or Ctrl+K (Windows/Linux) and gives you access to 90+ editor actions through a searchable interface. Type any action name — create query, go to component, toggle preview — to find and execute it instantly. It is the fastest way to navigate large apps and access features without hunting through menus.

Quick facts about this guide
FactValue
ToolRetool
DifficultyBeginner
Time required10 min
CompatibilityRetool Cloud and Self-hosted
Last updatedMarch 2026

Keyboard-Driven Development with Retool's Command Palette

Retool's command palette is a searchable overlay that gives you instant access to the most common editor actions without using the mouse. It is inspired by VS Code's Cmd+K interface and works similarly — you type a few characters of any action or resource name to filter results and press Enter to execute.

The command palette is especially valuable in large apps where you might have dozens of queries, multiple pages, and many components to navigate between. Instead of scrolling through the Code panel to find a query named 'fetchUserProfileAndRecentOrders', just press Cmd+K and type 'fetch' to jump to it immediately.

This tutorial covers opening the palette, the categories of available actions, practical workflow patterns, and how the command palette compares to Retool's full keyboard shortcut system.

Prerequisites

  • A Retool account (Cloud or Self-hosted)
  • Access to a Retool app in edit mode
  • No technical prerequisites — this is a UI navigation tutorial

Step-by-step guide

1

Open the command palette

Press Cmd+K on Mac or Ctrl+K on Windows and Linux while in the Retool editor. A search overlay appears in the center of the screen with a text input and a list of recently used or suggested commands. You can also open it by clicking the search/magnifying glass icon in the top toolbar. The palette closes when you press Escape or click outside it.

Expected result: A search overlay appears in the center of the editor with an input field and a list of available commands.

2

Search for and execute an editor action

Start typing any action name in the search field. The palette filters results in real time. Use arrow keys to navigate results and Enter to execute. Examples of commonly searched actions: 'preview' (toggle preview mode), 'new query' (create a new query), 'save' (save the app), 'duplicate' (duplicate a component), 'undo' (undo last change), 'settings' (open app settings).

typescript
1// Command palette search examples:
2// Type: 'prev' → Toggle preview mode
3// Type: 'new query' → Create new query
4// Type: 'save' → Save app
5// Type: 'dup' → Duplicate selected component
6// Type: 'dark' → Enable/disable dark mode
7// Type: 'settings' → Open app settings
8// Type: 'keyboard' → View all keyboard shortcuts
9// Type: 'perf' → Open performance monitor

Expected result: Matching commands appear filtered in the palette. Pressing Enter on a command executes it immediately.

3

Navigate to a specific query by name

Type the name of any query in the command palette to jump directly to it in the Code panel. This is one of the most useful features in large apps with many queries. Start typing 'get', 'update', 'fetch', or any word from the query name — the palette shows matching queries. Press Enter to select the query and Retool opens it in the Code panel with the query editor focused.

Expected result: The target query opens in the Code panel, selected and ready to edit.

4

Navigate to a specific component by name

In apps with many components, finding a specific one on the canvas can be tedious — especially in containers nested several levels deep. Type the component name in the command palette (e.g., 'table1', 'submitButton', 'orderStatusSelect') to select it on the canvas instantly. The canvas scrolls to the component and it appears selected with its Inspector properties showing on the right.

Expected result: The named component is selected on the canvas and its Inspector panel opens on the right.

5

Switch between pages in a multipage app

In multipage Retool apps, type the page name in the command palette to navigate to it quickly. This is faster than clicking the page tabs at the top of the editor, especially when you have many pages. Type the first few characters of any page name and press Enter to switch to it.

Expected result: The editor switches to the target page. The canvas shows the selected page's components.

6

Use the command palette for common editor operations

Several frequently used editor operations are fastest via the command palette. Here is a reference of the most useful commands organized by category: app management, component operations, view and layout, and debugging tools.

typescript
1// === App Management ===
2// 'Save' → Save app (also Cmd+S)
3// 'App settings' → Open gear/settings panel
4// 'Share' → Open sharing settings
5// 'Deploy' / 'Release'→ Deploy/release the app
6
7// === View & Layout ===
8// 'Preview' → Toggle preview mode (Cmd+P)
9// 'Dark mode' → Toggle editor dark mode
10// 'Zoom in/out' → Canvas zoom controls
11// 'Grid' → Toggle canvas grid
12
13// === Component Operations ===
14// 'Duplicate' → Duplicate selected component
15// 'Delete' → Delete selected component
16// 'Align' → Alignment options
17// 'Group' → Group selected components
18
19// === Debugging ===
20// 'Debug panel' → Open/close debug panel
21// 'Performance' → Open performance monitor
22// 'State inspector' → Open state inspector

Expected result: Common operations are accessible in under 2 seconds via keyboard, without navigating menus.

Complete working example

Command Palette Reference
1// Retool Command Palette — Essential Commands Reference
2// Open with: Cmd+K (Mac) | Ctrl+K (Windows/Linux)
3
4// === Navigation ===
5// [query name] → Jump to and select a query in Code panel
6// [component name] → Select component on canvas
7// [page name] → Switch to page (multipage apps)
8
9// === App Operations ===
10// 'Save' → Save current app (shortcut: Cmd+S)
11// 'Preview' → Toggle preview mode (shortcut: Cmd+P)
12// 'Settings' → Open App Settings
13// 'Release' / 'Deploy' → Open release/deploy panel
14// 'Share' → Open app sharing settings
15
16// === Component Commands ===
17// 'New component' → Open component picker to add new component
18// 'Duplicate' → Duplicate currently selected component
19// 'Delete' → Delete currently selected component
20// 'Select all' → Select all components on canvas
21
22// === Query Commands ===
23// 'New query' → Create new query
24// 'New JS query' → Create new JavaScript query
25// 'New transformer' → Create new transformer
26
27// === View Commands ===
28// 'Dark mode' → Toggle editor dark/light mode
29// 'Grid' → Toggle alignment grid on canvas
30// 'Zoom in' → Zoom canvas in
31// 'Zoom out' → Zoom canvas out
32// 'Fit to screen' → Reset canvas zoom to fit
33
34// === Debug Commands ===
35// 'Debug' → Open Debug Panel
36// 'State inspector' → Open State Inspector
37// 'Performance' → Open Performance tab
38// 'Keyboard shortcuts' → View all keyboard shortcuts

Common mistakes

Why it's a problem: Pressing Cmd+K inside a text input or code editor and it does not open the palette

How to avoid: Press Escape first to deselect the focused input, then press Cmd+K. The palette cannot open when a text field has focus because the keyboard shortcut is intercepted by the input.

Why it's a problem: Confusing the command palette with the full keyboard shortcuts list

How to avoid: The command palette (Cmd+K) is an interactive search UI for executing actions. The keyboard shortcuts list (accessible via command palette → 'keyboard shortcuts') shows all direct key combinations for actions that do not require the palette overlay.

Why it's a problem: Searching for a component by its label text instead of its component name

How to avoid: The command palette searches by component name (as shown in the component tree), not by the text label displayed on screen. A button labeled 'Submit Order' is found by searching its component name like 'submitOrderButton', not 'Submit Order'.

Best practices

  • Use the command palette as your primary navigation tool in apps with 20+ queries — searching is faster than scrolling the Code panel.
  • Learn 3-5 core commands by heart (save, preview, new query, debug panel) to build muscle memory for daily operations.
  • Name queries and components descriptively so command palette search returns unambiguous results (e.g., getOrdersByStatus, not query1).
  • Use the command palette to access rarely used settings (app settings, sharing) rather than hunting through menus.
  • The command palette is always available regardless of what panel or modal is open — press Cmd+K from anywhere in the editor.
  • Combine the command palette with keyboard shortcuts for maximum speed: Cmd+S to save, Cmd+P to preview, Cmd+K for everything else.

Still stuck?

Copy one of these prompts to get a personalized, step-by-step explanation.

ChatGPT Prompt

I am new to Retool and want to use the command palette efficiently. What are the 10 most useful commands I can access via Cmd+K in the Retool editor? Explain what each does and give me the keyboard shortcut if one exists as an alternative. Also explain how the command palette differs from the regular keyboard shortcuts in Retool.

Retool Prompt

I have a large Retool app with 40+ queries and 5 pages. I keep wasting time scrolling to find queries. How do I use the command palette to: (1) jump to a specific query by name, (2) switch between pages, (3) select a component buried deep in a container, and (4) quickly open the debug panel? Give me the exact keystrokes.

Frequently asked questions

What keyboard shortcut opens the Retool command palette?

Cmd+K on Mac and Ctrl+K on Windows and Linux. Make sure focus is not inside a text input or code editor when you press it — if it is, press Escape first to deselect, then press Cmd+K.

Can the command palette be used in preview mode (when the app is viewed by end users)?

No. The command palette is an editor-only tool. End users viewing the published or previewed app do not have access to it. It is exclusively for Retool app builders during development.

How many commands are available in Retool's command palette?

Retool's command palette provides access to 90+ editor actions covering app management, component operations, query navigation, view controls, and debugging tools. The exact number varies by plan and Retool version. Type anything into the search field to see all results matching your query.

RapidDev

Talk to an Expert

Our team has built 600+ apps. Get personalized help with your project.

Book a free consultation

Learning is great. Shipping is faster with help.

Our engineers have built 600+ apps on Retool and the tools around it. If your project needs to be live sooner than your learning curve allows — book a free consultation.

Book a free consultation

We put the rapid in RapidDev

Need a dedicated strategic tech and growth partner? Discover what RapidDev can do for your business! Book a call with our team to schedule a free, no-obligation consultation. We'll discuss your project and provide a custom quote at no cost.