DataGrip 2020.1 Help


File | Settings | Appearance and Behavior | Scopes for Windows and Linux

DataGrip | Preferences | Appearance and Behavior | Scopes for macOS

A scope is a set of files to which various operations apply. Using this dialog, you can define scopes for the various DataGrip actions, for example, Find Usages or Code Inspections.

Main toolbar

the Add button

Add scope

Add a new local or shared scope.
the Remove button


Delete the selected scope from the list.
the Copy configuration button

Copy configuration

Create a copy of the selected scope.
the Save as buttonSave asSave the selected local scope as shared or the selected shared scope as local.
the Move up button  the Move down buttonMove Up / Move DownMove the scopes up and down in the list.

Scope configuration controls

NameSpecify the scope name.

Specify the pattern that defines the current scope. The following elements and structures can be used:

  1. The file: modifier. The element is mandatory.

  2. The * asterisk to denote any symbol in a filename or file extension.

  3. Logical operators AND (&&), OR (||), and NOT (!).

Storing empty or incorrect patterns is not allowed. In such cases, DataGrip shows a Syntax Error warning.


Include a single file by its namefile:<directory>/<file>file:databases/create_schema.sql
Include a set of all files in a directory, without subdirectoriesfile:<directory>/*file:databases/mysql-db/*
Include a set of all files in a directory with subdirectoriesfile:<directory>//*file:databases/mysql-db//*
Include a file by its name from the certain projectfile[project_name]:<directory>/<file>file[default]:databases/create_schema.sql
Possible logical operators &&·(AND), ||·(OR), !·(NOT).file[project_name]:<directory>&&!file:<directory>file[default]:databases/*&&!file:databases/create_schema.sql

Include Included the selected item. If the current item is a folder, the nested subfolders are ignored.
Include RecursivelyInclude the selected folder and all nested subfolders with their contents.
ExcludeExclude the selected item. If the current item is a folder, the nested subfolders remain in the scope.
Exclude RecursivelyExclude the selected folder and all nested subfolders with their contents.

Scope toolbar

Project tree view

The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically.

Show filesShow Files

When this option is enabled, source files are displayed explicitly in the tree view. When the files are shown, they can be selected for exclusion/inclusion into a pattern.

If this option is not disabled, all files are hidden from the tree.

Show included onlyShow Included OnlyWhen this option is enabled, the tree shows only the elements that are included in the scope.
Last modified: 24 June 2020