Getting Started

Using Postico

Troubleshooting

More Information

You are looking at the documentation for Postico v1.3.5 — would you like to go to the latest version instead?

Keyboard Shortcuts in Postico

This page describes most keyboard commands supported by Postico. Standard Mac OS shortcuts are not included to keep the list manageable; I assume that you are familiar with them anyway.

The easiest way to discover keyboard shortcuts is to browse through the application menus. I mention this because people are increasingly ignoring the wonderful menu bar at the top of the screen. Some buttons also have shortcuts; just hover over them and the tooltip will tell you.

I've tried to follow platform conventions as much as possible when picking these keyboard shortcuts. The shortcuts should feel familiar to most people working on a Mac.

Postico has no built-in feature to change keyboard shortcuts. However, you can change any keyboard shortcut in System Preferences. Go to Keyboard → Shortcuts → App Shortcuts and you can change the shortcuts for any app on your Mac.

General Navigation

⌘N
Opens the favorite window. (when you want to make a new connection)
⌥⌘N
Opens a new window for the current connection.
⌘T
Opens a new tab for the current connection. (requires macOS 10.12 Sierra or later)
⌘1-9
Switch to tab 1 to 9.
⌘P
This is the “Open Quickly” command, also know as “Fuzzy Open”. This command lets you quickly jump to a table by typing part of the name.
⌘+
Increase font size.
⌘-
Decrease font size.
⌥⌘←
Navigate backwards in history.
⌥⌘→
Navigate forwards in history.
⌥⌘↑
Navigate up in the hierarchy (eg. table → database → server)
⌥⌘↓
Navigate down in the hierarchy (open the currently selected item)
⌘R
Reload. This command reloads the current view, the sidebar, and purges all cached views (except those with unsaved changes)
⌥⌘R
Reload current view only.
⌘.
Cancel current query. Note that it can take some time until the command reaches the server, and the server might not cancel the query immediately. Also, this command has no effect if the query has already completed but Postico is still busy downloading the results.
⌥⌘.
Disconnect from the server. All pending queries will be cancelled. This is sometimes the only way to abort an operation. Postico will reconnect to the server automatically as needed.
⌥⌘F
Filter tables or rows.
⇧⌘F
Filter the list of tables in the sidebar.
⌘0
Show or hide the left sidebar. (That's a zero)
⌥⌘0
Show or hide the right sidebar.
^⌘F
Enter Full Screen mode.

Table View

⌥⌘T
Switch between table contents and structure
⇧⌘N
Insert a new row
⌘D
Duplicate selected row(s)
⌘S
Save changes
⌥⌘F
Show or hide the table filter bar.
Edit next field (move right)
⇧⇥
Edit previous field (move left)
Edit field above (move up)
Edit field below (move left)
Commit changes to current field
esc
Abort editing and discard changes to current field
⌥⇥
Insert tab into field
⌥↩
Insert newline into field

SQL Query View

⌘↩︎
Execute the current query (or the current selection, if any)
⌥⌘↩︎
Execute all queries in the Query View
⌘.
Cancel the currently running query
⌘K
Clear results from the Query View.
⇧⌘T
Go the SQL Query View (used to be called the Terminal)
Depending on context, one of the following:
  • Trigger tab completion
  • Shift the selected line(s) to the right (increase indentation)
  • Insert a tab character or spaces
⌥⇥
Always inserts a literal tab character
⇧⇥
Shift the selected line(s) to the left (decrease indentation)
⌘]
Alternate shortcut for shift right
⌘[
Alternate shortcut for shift left
^⌘←
Replace the current query with the previous query from your history.
^⌘→
Replace the current query with the next query from your history.
⌘/
Comment or uncomment the selected line(s) by prepending two dashes
⌥⌘/
Comment (or uncomment) the selection with a block comment (/* */)
^H
Look up the current word (or selection) in Dash

Alerts

Confirm the default action
esc
Cancel the operation
⌘⌫
Use this shortcut to confirm when the alert asks you if you want to delete an object. (Return is not allowed on these alerts to avoid accidental deletions)

Legend of Keyboard Symbols

This is a list of keyboard symbols used above:

The Command key. Sometimes called "Apple key" since it used to have an Apple logo on older keyboards. Labelled "cmd" on newer keyboards.
The Option key. Labelled "option" or "alt" on modern Apple keyboards.
Shift. Lets You Type Capital Letters.
^
The Control key. Labelled "ctrl" on modern Apple keyboards.
The Tab key. Usually above the caps lock key. Inserts a horizontal space.
The Return key. Inserts a newline. Not to be confused with the "Enter" key.
The delete or backspace key. Located above the return key.
esc
The escape key. Usually on the top left corner of the keyboard.