Manage multiple projects

Last modified: 13 June 2023

Switch between projects

If you have several opened projects at the same time, you can switch between them using the following options:

Switch to the next project window: (Window | Next Project Window)
Switch to the previous project window: (Window | Previous Project Window)

Alternatively, open the Window menu and select the project to which you want to switch.

Merge project windows (macOS)

On macOS, you can merge all opened project windows into one, turning them into tabs.

Make sure that there are several DataGrip projects opened in separate windows.
Go to Window | Merge All Project Windows.
Drag a project's tab to work with the project in a separate window again.

Navigate projects on the Welcome screen

If you work with multiple projects, it's likely that you have a long list of recent projects on the Welcome screen. DataGrip provides several options that can help navigate this list in a more convenient way.

You can use the search bar to search for projects, join several recent projects in a group, or set a custom icon for each project.

Group projects

Groups make navigation simpler and help you logically organize your recent projects.

On the Welcome screen, right-click any project and select New Project Group.
In the Create New Project Group dialog, name the new group and click OK.
Right-click the project that you want to move to the new group, select Move to Group, and click the target group's name.

After that, hover over the group and use the icon to show the menu from which you can open all projects in the group at once by clicking All Projects in Group. You can also ungroup the projects, move them to another group, and remove them from the list of recent projects at once.

Change the project icon

For each project, you can configure a custom icon so that you can quickly find the necessary project on the Welcome screen. Your custom icon should have the SVG format.

On the Welcome screen, right-click the project for which you want to change an image and select Set Custom Project Icon.
In the dialog that opens, click Choose SVG file and specify the path to the necessary SVG icon.
Click OK to apply the changes.
To remove the custom icon, click in the Set Custom Project Icon dialog.

Manage multiple projects﻿

Switch between projects﻿

Merge project windows (macOS)﻿

Navigate projects on the Welcome screen﻿

Group projects﻿

Change the project icon﻿