DataGrip 2023.3 Help

New UI

The new user interface (UI) is a new redesigned look of DataGrip. It has been created to reduce visual complexity, provide easy access to essential features, and progressively disclose complex functionality as needed — resulting in a cleaner look and feel.

Among the key changes are the simplified main toolbar, new tool window layout, new themes, and updated icons.

Overview

Enable the new UI

  1. Press Control+Alt+S to open the IDE settings and then select Appearance & Behavior | New UI.

  2. Select the Enable new UI checkbox and apply the changes. Restart the IDE.

Main changes

Themes, icons, fonts

  • The new Light, Dark, and Light with Light Header color themes have improved contrast and a consistent color palette.

    Light theme in the new UI
    Light theme with light header in the new UI
    Dark theme in the new UI
  • The Inter font is used for the UI on all supported OSs.

  • A new icon set has more distinguishable shapes and colors designed for legibility and visual balance.

Window header

Several new widgets are located in the toolbar in the main window header. From left to right:

Window header
  1. Main menu (Windows and Linux only)

    The main menu is now hidden under the hamburger icon. To access menu categories, click the icon or press Alt+\. The elements will appear horizontally over other header widgets.

    You can display the main menu as a separate toolbar: go to Settings | Appearance & Behavior | New UI and enable the Show main menu in a separate toolbar option. Alternatively, go to View | Appearance and enable Show Main Menu in Separate Toolbar.

  2. Project widget

    The widget shows the current database's name, allows switching between recent databases, creating new databases, and opening existing ones.

  3. VCS widget

    The widget shows the current branch, allows switching branches, and provides the most popular VCS actions like update project, commit and push changes.

    It has replaced the branch widget previously located in the status bar at the bottom of the main window, and VCS actions icons previously located in the navigation bar in the upper right corner.

  4. Tool window bar

    In DataGrip, window header also contains the tool window bar with tool window icons.

    For more information about tool window bar, refer to the Tool windows chapter.

While giving access to more features right from the main toolbar, new window header widgets hide actions in drop-down menus to simplify the layout.

Tool windows

Tool windows have a new layout and behavior:

  • The combined tool window bar is located at the top and holds all the icons. The icons are big for easier visual navigation and a cleaner look. You can opt for smaller icons in the compact mode. To see a tool window's name, hover over its icon for a tooltip.

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

    Tool window icon tooltips
  • 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).

    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 open other tool windows from the toolbar, click the More tool windows button (the More tool windows icon) and select the tool window that you want to open. The icon of that tool window will not appear on the toolbar.

  • Use the vertical and horizontal split to arrange tool windows: drag a tool window along the sidebars that appear.

Editor tabs

  • Tabs use more space and a bigger font for better legibility.

  • Working with multiple editor tabs is now more convenient: if tabs do not fit the screen, you can choose between using a scroll bar, squeezing the tabs to fit all of them on the screen, or placing tabs in rows. Go to Settings | Editor | General | Editor Tabs | Show tabs in and select the required option.

    Scroll tabs
    Squeeze tabs
    Multiple rows

Gutter

  • Breakpoints are now placed over line numbers by default to save horizontal space.

    You can place breakpoints near line numbers: press Control+Shift+A, type Breakpoints Over Line Numbers, and disable the option.

    Breakpoints
  • Folding icons have been updated. Icons for unfolded areas show up on hover for a less cluttered look.

    You can configure the IDE to always display folding icons: go to Settings | Editor | General | Code Folding and select Always next to Show code folding arrows.

    Code folding
  • Annotations (Git Blame) have an updated color palette to help you see the recent changes faster.

    Git Blame annotations

Debug tool window

Two separate toolbars with the main debug actions were streamlined and moved to a single toolbar near the tool window tabs for better screen space management.

Tabs for switching between the Threads & Variables view and Console now also appear in the tool window tabs when there is a single running configuration.

Debugger tool window

The navigation bar is now located in the status bar at the bottom of the main window.

Navigation bar in the new UI

If you prefer the former location, you can move it back to the top, or even turn it off completely. To do so, go to the main menu and select View | Appearance | Navigation Bar.

Compact mode

If you work on a smaller screen, you can enable the compact mode. In this mode, the IDE has the reduced heights for toolbars and tool window headers, scaled-down spacings and paddings, and smaller icons and buttons.

Enable Compact mode

  • Go to View | Appearance | Compact Mode.

  • Press Control+Alt+S to open the IDE settings, select Appearance and Behavior | New UI, and enable the Compact mode option.

Compact mode
Compact mode turned off

Import dialog

In the Import dialog, you can import data from a CSV file, a table, and a query result set by defining a corresponding mapping.

For more information about the new dialog controls, refer to Import dialog.

Import dialog with CSV, Table, and Query Source mappings in the mapping tree
Last modified: 18 December 2023