<html><head><link rel="canonical" href="https://www.jetbrains.com/help/writerside/find-usages.html.md/" data-react-helmet="true"/></head><body># Find usages

When you write or edit documents, you might want to change some element, for example, a topic, or even delete it.

Before applying such changes, a good practice is to check whether this topic or snippet is referenced or included in other documents.

## Find usages

Procedure:

1. Step on the id in the `topic` or `snippet` element.

2. Right-click and select the Find usages option or press `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Alt+F7` (NetBeans), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS)).

3. Check the results in the Find tool window. The results will be grouped into Include, Topic, Topic link, and Toc element tree areas. In the Topic link area, see all references to a specific topic. In the Toc element area, see how a topic is used in a Table of contents. In Include area see where a topic is included.

![Find tool window](https://resources.jetbrains.com/help/img/writerside/Find_tool_window.png)

4. Select an item to display in the Preview area to the right. Here you can check a specific usage or edit it.

5. If too many results are found, click ![Settings icon](https://resources.jetbrains.com/help/img/writerside/icon_gearPlain.png) on the toolbar in the Find tool window to [manage scopes](#limit-scopes).

&gt; **Note:**
&gt; If a topic is included in more than one other, consider moving it into the snippets library.

## Manage scopes

Sometimes in the results, you can see many links, but most of them are for other instances. You can apply Find usages action only to specific instances by limiting scopes.

Procedure:

1. Press `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Alt+F7` (NetBeans), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS)) to open the Find Usages dialog.

2. Click ![Settings icon](https://resources.jetbrains.com/help/img/writerside/icon_gearPlain.png) on the toolbar.

3. In the Scope field, select a scope for your search.

![Find usages](https://resources.jetbrains.com/help/img/writerside/Find_usages_scopes.png)

4. You can limit scope only to topics and libraries included in the current or not in the current instance.

</body></html>