PhpStorm 2020.3 Help


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

Main toolbar

Item Tooltip Description
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 button Save as Save the selected local scope as shared or the selected shared scope as local.
the Move up button  the Move down button Move Up / Move Down Move the scopes up and down in the list.

Scope configuration controls

Item Description
Name Specify 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 (!).

For more information, see Scope language syntax reference.

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


  • file:*.php||file:*.twig - include all PHP and Twig files.

  • file:*php&&!file:*test*.php - include all PHP files except those that contain the character string test in their names.

  • file:www/wp-content/themes/my-site-child//*.php||file:www/wp-content/themes/my-site-child//*.css||file:www/wp-content/themes/my-site-child//*.js||file:www/wp-content/plugins/my-site//*.php||file:www/wp-content/plugins/my-site//*.css||file:www/wp-content/plugins/my-site//*.js - include all .PHP, .CSS, and .JS files from the theme and plugin of the WordPress website.

  • file:*.js||file:*.coffee - include all JavaScript and CoffeeScript files.

  • file:*js&&!file:*.min.* - include all JavaScript files except those that were generated through minification, which is indicated by the min extension.

  • !file:*/.npm//* - exclude all .npm folders.

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

Scope toolbar

Item Tooltip Description
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 files Show 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 only Show Included Only When this option is enabled, the tree shows only the elements that are included in the scope.

Legend of the project tree view

Item Description
the green color sample Folders and files included in a scope are marked with green.
Black Folders and files excluded from a scope.
the dark blue color sample Folders that contain both excluded and included files and subfolders are marked with dark blue.
Last modified: 18 October 2020