Troubleshooting problems with keyboard shortcuts
First of all, check whether the shortcut should work as you expect. It may be obvious for shortcuts like and , but shortcuts like Alt+Up or often perform different actions depending on the application and the operating system.
Taking into account different expectations regarding shortcuts, DataGrip lets you choose between keymaps (predefined sets of shortcuts).
Press to open settings and then select Keymap.
Make sure that you are using the correct keymap.
Use the search field to check whether the shortcuts are mapped as expected.
Alternatively, you can select the desired keymap at the top of this documentation page, and check the list of shortcuts to study keyboard mappings in that keymap.
If you think that the default mapping for a specific shortcut is incorrect for a particular keymap, let us know by filing an issue in our issue tracker.
All keymaps in DataGrip are designed for the QWERTY US English keyboard layout. If you use a keyboard layout for another Latin-script alphabet, some shortcuts may not work because characters used in those shortcuts may not have dedicated keyboard keys.
For example, there is no dedicated keyboard key for the forward slash / in the German keyboard layout, and therefore it is impossible to use the shortcut to comment the current line.
The recommended workaround in this case is to install the Keymap Nationalizer plugin, which will generate a non-conflicting keymap for your keyboard layout. Alternatively, you can fix specific shortcuts by assigning another shortcut instead of the one that doesn't work.
Regardless of the workaround, we're still looking for a solution that would work out-of-the-box for any keyboard layout. The progress is tracked in this issue.
If the shortcut includes function keys F1... F12, it may not work because these keys are often mapped to utility actions by default, such as changing speaker volume or screen brightness.
You can make such shortcuts work in one of the following ways:
On keyboards that have a Fn key, press this key together with the original key combination.
Change the default behaviour of function keys. The procedure varies depending on your computer manufacturer; if you are running DataGrip on macOS, refer to this article.
On the Keymap settings page, click Find Actions by Shortcut, and then press the key combination.
If the field in the Find Shortcut popup remains empty after you press a key combination. This means that some other program or your operating system intercepted the shortcut.
Check the applications that have to react to shortcuts even when another application has focus. These normally include screen recording software or tunnelling tools such as Microsoft Remote Desktop.
When you find the conflicting shortcut, decide which application should react on this shortcut and either assign another shortcut in DataGrip or change the shortcut in the conflicting application.
There are several known conflicts in most of the predefined keymaps, for example:
Shortcut | System action | DataGrip action |
|---|---|---|
Select the previous input source | Basic code completion | |
Search man Page Index in Terminal | Find Action |
Try the macOS System Shortcuts keymap, which was designed to avoid conflicts with native macOS shortcuts. If you still find conflicts when using this keymap, file an issue in our issue tracker.
If you don't want to use this keymap, assign another non-conflicting shortcut in DataGrip.
There are several known conflicts on Ubuntu, for example:
Shortcut | System action | DataGrip action |
|---|---|---|
Shade window | Open the Settings dialog | |
Lock screen | Reformat Code | |
Launch Terminal | Surround With | |
Open the tty12 virtual console | File path | |
Switch between Workspaces | Undo/redo navigation operations | |
Move window | Find Usages | |
Resize window | Evaluate Expression |
Unfortunately, there is no predefined keymap that works without conflicts on Ubuntu and other Linux distributions. We're gathering feedback in this ticket.
Until an Ubuntu-friendly keymap is released, assign non-conflicting shortcuts that you would use most often.
There are no known conflicts with Windows system shortcuts. If you come across such conflict, let us know by filing an issue in our issue tracker.
When the shortcut that you pressed appears in the Find Shortcut popup, this means that the IDE can handle this shortcut. Check the list of actions mapped to this shortcut:
If the expected action doesn't appear in the list, assign a shortcut manually as a workaround, and file an issue in our issue tracker.
If the expected action appears together with other actions, it is by design in most cases because those actions should be available in different contexts. In the example below, the Ctrl+Shift+U shortcut is assigned to both Toggle Case, which works in the editor, and Unshelve, which works in the Commit window.
If the shortcut doesn't work as expected or doesn't work at all in specific context, remove shortcuts from other actions (right-click and choose Remove shortcut) as a workaround, and file an issue in our issue tracker.
If you have custom plugins installed on the Plugins page, there may be a chance that one of them intercepts the shortcut. Try disabling custom plugins and see whether it helps.
If the expected action appears in the list without other actions, but it still doesn't work as expected in the expected IDE context, assign some other shortcut manually as a workaround, and file an issue in our issue tracker.