Skip to main content

Keyboard Shortcuts

Defaults are listed below. Most shortcuts are rebindable in Settings > Keyboard; see Customizing shortcuts. The same key can do different things depending on focus: Cmd+[ indents in the editor and pages back in the data grid.

Essential

SQL Editor

Query Execution

File Operations

Text Editing and Find

Every row except Find Next and Find Previous is built into the editor and cannot be rebound. Standard macOS text navigation and clipboard keys also apply.

Data Grid

Editing

Clipboard

With a drag-selected cell range, Cmd+C copies the range as TSV. With a single focused cell it copies that value. Otherwise it copies the selected rows as TSV.

Pagination

Cmd+[ and Cmd+] page the data grid. In the SQL editor the same keys indent and outdent. Focus decides which fires.

Filtering

See Filtering for the filter panel itself.

Import and Export

Tabs and Windows

Connections

Result Tabs

Query History Panel

With the panel open (Cmd+Y): Return loads the selected entry in the editor, Delete removes it, Cmd+C copies its query.

Welcome Window

Ctrl+J/Ctrl+N and Ctrl+K/Ctrl+P also move the selection in the Quick Switcher.

CSV Inspector

See CSV Inspector.

Vim Mode

Turn on Vim mode in Settings > Editor. Vim keys apply only in the SQL editor; the data grid keeps its shortcuts, and Cmd+Enter runs the query in any mode. See Vim Mode for the key reference.

Customizing Shortcuts

Open Settings (Cmd+,) > Keyboard. Each action has a recorder field: click it and press the new combination. The menu bar updates immediately. Use the search field to filter actions, press Delete in a recorder field to clear a binding, click the curved-arrow button next to a changed shortcut to restore that one action, or Reset to Defaults to restore all. See Settings for the other tabs.
Keyboard settings

Keyboard shortcut customization

If a combination is already used by another action in the same context, TablePro shows a dialog naming that action: Cancel keeps the existing assignment, Reassign moves the shortcut and clears it from the other action. Editor and data grid shortcuts can share a key without conflict because focus decides which fires. Menu actions need a modifier (Cmd, Option, Ctrl, or Shift); function keys F1 through F12 work bare, as do grid actions that read the key directly, like Preview FK Reference (Space).
Some shortcuts cannot be reassigned: editor built-ins (like Cmd+/), tab selection (Cmd+1 through Cmd+9), text size (Cmd+=, Cmd+-), and macOS system shortcuts, which TablePro reads live from System Settings. The recorder warns if you try.

Outside the App

TablePro can be driven without app shortcuts at all: the Raycast extension, the tablepro:// URL scheme, and MCP clients are covered in the External API section.