PyCharm 2024.1 Help

View usages of a symbol

Using the Show Usages function, you can bring up a list of symbol usages across the whole project.

View the usages of a symbol across the project

  1. Place the caret at the desired symbol in the editor.

  2. From the main menu, choose Edit | Find | Show Usages, or press Ctrl+Alt+F7.

  3. Examine and analyze the detected occurrences of a symbol:

    • Use the toolbar buttons to present search results in the desired way.

    • To jump from search results to a line of a source code, click the desired entry.

    • To close the list, press Escape.

    Show usages popup
  4. If necessary, customize the search options in the search options dialog. To invoke the dialog, do one of the following:

    • In the Show Usages popup, click the Settings button the Settings button.

    • Press Ctrl+Alt+Shift+F7.

The Find tool window displays a toolbar with the following buttons:




the Group by method button

Group by file structure

If this toggle is on, the found usages are shown under the corresponding method nodes.

the Merge usages from the same line button

Merge usages from the same line

Merge usages of the symbol from the same line.

the Show read access button

Show read access

Show read access to the symbol.

the Write read access button

Show write access

Show write access to the symbol.

the Show import statements button

Show import statements

Show usages in the import statements.

the Settings button


Open the Find Usages dialog for the selected symbol where you can change the search options.

Last modified: 11 February 2024