PyCharm 2016.3 Help

Highlighting Usages

On this page:


The search command Highlight Usages in File (Ctrl+Shift+F7) makes it possible to visualize usages of a symbol in the current file.

All found usages of a symbol in the current file are highlighted and color-coded, as defined in the Colors and Fonts settings page, to represent read or write access to the symbol. In addition to the highlights of occurrences in text, the stripes of the same colors appear in the marker bar, accompanied with tooltips.


The behavior of usage highlighting is configurable: you can make PyCharm show usages of a symbol at caret automatically, or invoke it with a command.

Configuring automatic highlighting

To configure highlight usages behavior

  1. Open the Settings/Preferences dialog.
  2. In the Editor page of the IDE Settings, select the check box Highlight usages of element at caret to enable automatic usage highlighting.

Highlighting usages in the current file

To highlight usages of a symbol in the current file

  1. Place the caret at the selected symbol in the editor. If automatic usages highlighting is enabled, see all its occurrences in the current file highlighted. Otherwise, proceed to the next step.
  2. On the main menu, choose Edit | Find | Highlight Usages in File, or press Ctrl+Shift+F7.

Navigating among usages

To navigate among usages, do one of the following

  • Click on a stripe in the marker bar to navigate to the respective usage location.
  • Use F3 and Shift+F3 keyboard shortcuts, to navigate to the next and previous usages respectively.

Removing highlighting

To remove highlighting of usages

  • Press Escape.

See Also

Last modified: 23 December 2016