DataGrip 2024.1 Help

Tool windows

Tool windows provide access to development tasks: viewing your project structure, running and debugging your application, integration with version control systems and other external tools, code analysis, search, navigation, and so on. By default, tool windows are attached to the bottom and sides of the main window. However, you can rearrange and even detach them to use as separate windows, for example, on another monitor.

Tool windows
  1. Database Explorer

  2. Files tool window

  3. Services tool window

Some tool windows are always available (for example, Database Explorer, Files, and others), some are activated when a specific plugin is enabled, and some appear only when you perform a certain action (for example, Services, Debug, and Find) .

Open a tool window

To show or hide a tool window, do one of the following:

  • Go to a tool window under View | Tool Windows.

  • Use the corresponding shortcut, for example, Alt+2 to open the Files tool window . If there is no shortcut for a tool window, you can assign it as described in Configure keyboard shortcuts.

  • Click the corresponding tool window button on the tool window bar.

    Tool window bar
  • Click the More tool windows icon (the More tool windows icon) on the tool window bar and select the tool window. Note that the icon of that tool window will not appear on the toolbar unless you pin it.

  • In the Classic UI, hover over the quick access button Icon for quick access to tool windows/the Tool windows icon in the lower left corner of the main window and select a tool window.

    Quick access to tool windows

Hide the active tool window

  1. Press Shift+Escape or select Window | Active Tool Window | Hide Active Tool Window from the main menu.

    To show the hidden tool window, use the shortcut assigned to it (go to View | Tool Windows to see the full list of tool windows with shortcuts).

  2. Right-click the tool window's icon on the toolbar and select Hide.

  3. Click the Hide button (the Hide icon) on the tool window's title bar.

To focus your attention on the editor, you can hide all tool windows and when necessary, quickly restore all windows that were open when you've hidden them.

Hide or restore all tool windows

  • Press Ctrl+Shift+F12.

  • Double-click the editor tab that you want to maximize. This will only work if Perform 'Hide All Tool Windows' / 'Restore Windows' with double-click on editor tab is enabled on the Advanced Settings page of the IDE settings  Ctrl+Alt+S.

  • Select Window | Active Tool Window | Hide All Windows/Restore Windows from the main menu.

Pin and unpin tool windows

  • To pin other tool window icons, click the More tool windows icon (the More tool windows icon), navigate to the tool window whose icon you want to pin, and click the Pin button (the Pin icon).

  • To unpin a tool window icon, right-click it and select Unpin. Alternatively, click the More tool windows button (the More tool windows icon), navigate to the tool window whose icon you want to unpin, and click the Unpin button (the Unpin icon).

  • To change focus from a tool window to the last caret location in the editor, press Escape.

  • If you selected a code item in a tool window, for example, a search result, a code issue, or a bookmark, press F4 to open the corresponding file and locate this item in the editor.

  • To change focus from the editor back to the last active tool window, press F12 or select Window | Active Tool Window | Jump to Last Tool Window from the main menu.

Tool window bars and buttons

Tool window bar is located in the main window header and contains the icons of tool windows. Click an icon to show or hide the tool window. Right-click a tool window icon to open the context menu, where you can hide or move the tool window. You can also drag tool window icons to rearrange tool windows.

By default, the toolbar has icons of the following tool windows: Database Explorer (the Database Explorer icon), Services (the Services tool window icon), and Files (the Files tool window icon).

Tool window bar

Switch to multiple tool window bars

  • To switch back to multiple tool window bars, press Ctrl+Shift+A, find the Use Single Tool Window Bar toggle, and turn it off.

Show or hide tool window icons

  • Select or clear Tool Window Bars from the main menu under View | Appearance.

When the tool window bars are hidden, you can double-press and hold Alt to show them.

Tool window bars on the edges of the main window contain buttons to show and hide tool windows. Right-click a tool window button to open its context menu, where you can change the viewing mode and move the tool window. You can also drag tool window buttons to rearrange tool windows.

Tool windows bar and buttons

Show or hide tool window bars

  • Click the quick access button Icon for quick access to tool windows in the lower left corner of the main window to hide the tool window bars. The button changes to Icon for quick access to tool windows and you can click it to show the tool window bars.

  • Alternatively, select or clear Tool Window Bars from the main menu under View | Appearance.

When the tool window bars are hidden, you can double-press and hold Alt to show hidden tool window bars.

Tool window components

Generally, all tool windows have a title bar, a toolbar, and a content pane.

Tool window layout
  1. Title bar

  2. Toolbar

  3. Content pane

Some tool windows have multiple sections presented as tabs or a dropdown selector in the title bar, based on the covered functionality. Select Window | Active Tool Window | Group Tabs to show tabs. Disable this option to show a dropdown menu.

The Files tool window with the Group Tabs option enabled
The Files tool window with the Group Tabs option disabled

The title bar contains the tool window options menu The tool window options menu/Options for changing the viewing mode and the position of the tool window. You can also access these options by right-clicking the title bar or the tool window button. Some tool windows can have other options in this menu, depending on the functionality (for example, to sort, filter, and group items listed in a tool window).

Click the Hide button to hide the tool window and use other buttons that may be on the title bar, for example:

  • The Expand All button and The Collapse All button to expand and collapse the contents of the tool window

  • The Select Opened File button to locate and select the file from the editor in the tool window

Actions from the tool window toolbar are usually also available in the main menu and context menus. Some of them can also be executed with a default shortcut. You can assign shortcuts for actions as described in Configure keyboard shortcuts.

For all tool windows that display tree-like structures (for example, Files tool window) you can display vertical lines that mark indent levels in tree views and help you better understand the hierarchy of the components in your project. To display these lines, enable Show tree indent guides on the Appearance and Behavior | Appearance page of the IDE settings  Ctrl+Alt+S.

You can use the following shortcuts to manage DataGrip's tool windows:

Hide Active Tool Window

Shift+Escape

Hide All Tool Windows

Ctrl+Shift+F12

Jump to Last Tool Window

F12

Stretch to Left

Ctrl+Alt+Shift+Left

Stretch to Right

Ctrl+Alt+Shift+Right

Stretch to Top

Ctrl+Alt+Shift+Up

Stretch to Bottom

Ctrl+Alt+Shift+Down

Show Database Explorer

⌘ 1

Show Files window

Alt+2

Show Find window

Alt+3

Show Run window

Alt+4

Show Debug window

Alt+5

Show Problems window

Alt+6

Show Structure window

Alt+7

Show Services window

Alt+8

Show Version Control window

Alt+9

Show Commit window

Alt+0

Show Terminal window

Alt+F12

Last modified: 09 April 2024