Find tool window

The Find tool window displays the results of the following searches:

Find/Replace in Path
Find Usages
Structural search and replace
Refactoring Preview
Find Usages of a data source, a table, or a column.

The Find tool window can contain several tabs. By default, search results are updated in the current tab on every search. To show the results of each search in a separate tab, right-click the tool window title bar, and then select View Options | Open Results in New Tab.

By default, the Find tool window appears at the bottom of the screen. It has a toolbar with a set of buttons, a pane of results, and additional buttons for Replace in Path, and Refactoring Preview operations.

Item	Tooltip and Shortcut	Description
	Options `Ctrl+Alt+Shift+F7`	Click this button to open one of the Find Usages dialogs, which corresponds to the symbol. You can edit the search settings and click Rerun button to execute the modified search query.
	Rerun `Ctrl+F5`	Repeat the last search. This button is not available for viewing code coverage results.
	Close `Ctrl+Shift+F4`	Close the current tab or the tool window. This button is not available in Replace in Path and Refactoring Preview dialogs.
/	Expand all `Ctrl+NumPad +` Collapse all `Ctrl+NumPad -`	Use these buttons to have all nodes expanded or collapsed.
/	Previous/next occurrence `Ctrl+Alt+Up` `Ctrl+Alt+Down`	Navigate to the previous/next element in the tab of results.
	Group by	Click this icon to open the menu for the following grouping options: File Structure `Ctrl+S`: select this option to display the found usages under the corresponding method nodes. Module `Ctrl+Alt+M`: if you select this option, the found usages will show under the corresponding module or the library node. This type of grouping is helpful, when a package is split between several modules. Flatten Modules`Alt+O`: select this option to display all the modules as a single-level tree view. Group by directory `Ctrl+P`: select this option to show all the usages of a symbol under the directories where they are found. Test/Production: select this option to group the usages according the Production and Test scopes. Usage type `Ctrl+T`: turns grouping usages by categories on or off. Merge Usages from the Same Line: select this option to merge the duplicate usages found on the same line.
	Show read access `Ctrl+R`	This button is available for Find Usages only. If this button is pressed, the search results include references to the read access methods.
	Show write access `Ctrl+W`	This button is available for Find Usages only. If this button is pressed, the search results include references to the write access methods.
	Show import statements `Ctrl+I`	This button is available for Find Usages only. If this button is pressed, the search results include the usages in the import statements.
	Show $this/self references	This button is available for Find Usages only. By default, PhpStorm filters out usages of the class where some of its members are accessed via `$this->` or `self::` references. If this button is pressed, such usages are included is search results.
	Preview Usages	Click this icon to open the Preview pane next to the search results.

Context menu commands

Item	Shortcut	Description
Rerun	`Ctrl+F5`	Run the action again and show the results on the same tab.
Jump to Source	`F4`	Navigate to the selected item in the source code.
Include	`Insert`	For an excluded item: include the item in the list of results.
Exclude	`Delete`	Exclude the selected item from the list of results. (Excluded items are shown strikethrough.) When you carry out the Replace All or the Do Refactor command, the excluded items are not affected.
Remove	`Ctrl+X`	Remove the selected item from the list of results.
Recent Find Usages	`Alt+Down`	Show the list of recent searches. Select an item in the list to see the search results.
Export to Text File	`Alt+O`	Save the contents of the current result tab. In the Export preview dialog, specify the target file or copy information to the clipboard. Before saving, you can also modify the information to be saved.

Upper Toolbar buttons

Icon	Tooltip	Description
	Show Options Menu	Click this icon to open a menu with more options for managing the tool window such as displaying or hiding side toolbars, group tabs, selecting viewing mode, resizing, and so on.
	Hide	Hides the tool window. Press `Alt+3` to restore it.

Last modified: 06 October 2022