Skip to main content
A keymap maps actions to keyboard and mouse shortcuts. Every command in OpenIDEA is an action with a stable id, so any of them can get a shortcut.

​
Bundled keymaps

The default shortcuts are listed in the shortcut reference. Inside the IDE, Help › Keymap Reference lists every bound action of the active keymap and filters by action name, action id or shortcut.

​
Switch keymaps

Open Settings › Keymap and pick one in Keymap:. You can also switch from the Welcome screen (Customize › Keymap) or with View › Quick Switch Scheme… › Keymap. If you have changed shortcuts on a bundled keymap, switching to another bundled keymap carries your changes over.

​
Change a shortcut

In Settings › Keymap, find the action:
  • Type in Search actions to filter by name, or
  • Click Find Actions by Shortcut and press a shortcut to see which actions use it.
Actions are grouped as Main Menu (File to Help), Editor Actions, Tool Windows, Other and Plugins. Right-click an action, or select it and press Enter or double-click, to open its menu:
  • Add Keyboard Shortcut: press the keys in the dialog. Check Second stroke: for a two-stroke chord such as ⌘K ⌘C. The dialog lists conflicts; when you confirm, choose Remove to take the shortcut away from the other actions, or Leave to keep both.
  • Add Mouse Shortcut: click with Ctrl, Alt or Command held, or press a mouse side button.
  • Remove a single shortcut of the action.
  • Reset Shortcuts to go back to the keymap’s defaults for that action.
Changes are saved with Apply or OK.
Faster: open Find Action (⇧⌘A / Ctrl+Shift+A), highlight an action and press ⌥↵ / Alt+Enter to assign a shortcut to it directly.

​
Your own keymaps

The gear button next to Keymap: has:
  • Duplicate…: copy the selected keymap under a new name. Your keymap keeps the bundled one as its parent and stores only its differences.
  • Rename… and Delete for keymaps you created.
  • Restore Defaults: drop all your changes to the selected keymap.

​
Keymaps in settings.toml

Keymap settings are global and live in settings.toml (see Settings reference):
  • keymap is a bundled keymap id or the id of one of your keymaps.
  • keymapOverrides maps an action id to its shortcuts on top of a bundled keymap. An empty list unbinds the action.
  • customKeymaps.<id> holds a keymap you created: name, parent (a bundled keymap id) and its own overrides.
Shortcut syntax: Keys are matched by their physical position, so ⌥ combinations work on macOS layouts that type symbols with Option. To find an action’s id, look it up in the bundled keymap files, for example intellij-macos.ts.

​
Shortcuts that don’t reach the IDE

Some keys are taken by the operating system or another app before OpenIDEA sees them, for example macOS’s ⌃⌘D (Look Up in Dictionary) or a GPU overlay’s hotkeys on Windows. Change the conflicting system or app shortcut, or assign another shortcut in OpenIDEA. Vim mode can also claim keys in the editor; see Vim mode.