Table of Contents



Key Bindings

This interface works like the keyboard shortcut system in profiles (described above) but it affects all profiles. Settings here are overridden by those in a profile's key mappings.

See the list of key binding actions at Preferences > Profiles > Keys.

Add Touch Bar Item

This button is only visible if your OS version supports touch bars. By pressing this button, you can define a new custom touch bar button with any of the actions you can assign to a key (see below). You can then add the custom button to your touch bar with View > Customize Touch Bar.

Touch Bar Mitigations

This opens a panel with these options:

  • Haptic feedback when pressing esc When you press esc on a touchbar, this makes the trackpad vibrate to provide feedback.
  • Key click for virtual esc key When you press esc on a touchbar, this causes a click sound to be played.
  • Visual esc key indicator When you press esc on a touchbar, make the cursor change shape briefly to provid feedback.

Navigation Shortcuts

Shortcut to activate a tab

Tabs are normally navigated with cmd+number, but you can change the modifier used for that function here.

Shortcut to activate a window

Windows are normally navigated with cmd+opt+number, but you can change the modifier used for that function here.

Shortcut to choose a split pane

You can use this to configure a modifier+number shortcut to select a split pane in the current tab.

Emulate US Keyboard

If your keyboard layout requires you to hold Shift (or some other modifier) to press a number, enable this to treat the top row of keys as number keys even when Shift is not pressed. This only affects switching panes, tabs, and windows by keyboard as configure in the preceding settings.


Create a Dedicated Hotkey WIndow

Sets up a new hotkey window profile if you don't already have one. For more information, see Hotkey Windows.

Show/Hide iTerm2 all windows with a system-wide hotkey

When enabled, you can focus the Hotkey: field and press a keystroke. From then on, pressing that keystroke (even when iTerm2 is not the front application) will cause iTerm2 to come to the front. If it is the foreground app, it will be sent to the back. This requires that you enable access for assistive devices in the Universal Access panel of System Preferences. For more information, see Hotkey Windows.

Remap Modifiers

iTerm2 allows you to change the meanings of the modifier keys only within iTerm2. This is useful, for example, if you find it difficult to press "option" for "meta" and would prefer to use "command" for that purpose.

Global shortcut keys