Getting Started

Using Postico


More Information

You are looking at the documentation for Postico v1.5.15 — 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

Opens the favorite window. (when you want to make a new connection)
Opens a new window for the current connection.
Opens a new tab for the current connection. (requires macOS 10.12 Sierra or later)
Switch to tab 1 to 9.
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)
Reload. This command reloads the current view, the sidebar, and purges all cached views (except those with unsaved changes)
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.
Filter tables or rows.
Filter the list of tables in the sidebar.
Show or hide the left sidebar. (That's a zero)
Show or hide the right sidebar.
Enter Full Screen mode.

Table View

Switch between table contents and structure
Insert a new row
Duplicate selected row(s)
Save changes
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
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
Clear results from the Query View.
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 (/* */)
Look up the current word (or selection) in Dash


Confirm the default action
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.
The escape key. Usually on the top left corner of the keyboard.