PyCharm 2021.1 Help

Rename dialog for a file

Use this dialog to rename a file.

In addition to renaming the file itself, PyCharm can also look for the usages of the file name. If found, the changes you are making to the file name can also be applied to these usages.

The usages are assigned to different categories which correspond to the options which you can turn on and off.

Note that regardless of the options selected, the search scope (places where you search for the name occurrences) is always limited to the current entity (for example, a file, or a class) and the entities that the current one depends on.

ItemDescription
Rename <file> and its usages toSpecify a new name for the file.
Search in comments and stringsIf this checkbox is selected, PyCharm will look for occurrences of the file name within comments and string literals in your source code files.
Rename parameters in hierarchy

If this option is on, PyCharm will look for occurrences of the file name in the names of its inheritors. If you are renaming a class, PyCharm will search the hierarchies of the classes that extend this class.

Search in loaded sourcesIf this checkbox is selected, PyCharm will look for occurrences of the file name within downloaded object sources.
SQL ScriptThe statement to be run to rename the table or column. If necessary, you can edit the statement right in this pane.
RefactorExecute the statement and make associated changes right away.
PreviewPreview potential associated changes prior to executing the statement.
Search for text occurrencesIf this option is on, PyCharm will look for occurrences of the file name in the files that don't contain source code. These may be the text files, properties files, HTML files, documentation files, and so on.
ScopeUse this option to set a scope for the Rename refactoring. For example, you can limit the refactoring to only recently changed files, or to only open files, and so on. You can also create a custom scope that you can either share or keep local.
Last modified: 08 March 2021