Besides standard settings that you frequently use, PyCharm offers various advanced options that you can use to fine-tune the behavior of the specific product functionality.
Since the advanced settings consist of different sections, you can use the search field to quickly navigate to the section of interest or the needed option. You can also search for registry keys since some of advanced options have associated registry keys.
Show only line bookmarks in popup
By default, PyCharm shows only line bookmarks in the bookmarks popup (Shift+F11 or Bookmarks.). Disable this option if you want to see other bookmarked items in the popup, for example, files or folders. For more information, see
Maximum number of recent expressions
The number of expressions to be saved in the Evaluate expression history.
Connect to Docker automatically at restart
Select to connect to the configured Docker daemon after PyCharm starts.
Image registry entities loading limit
For performance reasons, by default, PyCharm shows only the first 100 images in a Docker registry. Increase this number if you need to list more. This will also increase the memory usage.
The log tab should be the first tab for the docker container
Show the Log tab as the first tab in the container overview pane.
Use this section to configure additional options for working in the editor.
Don't copy/cut the current line when invoking the Copy or Cut action with no selection
This option lets you override the default behavior of copying Ctrl+C or cutting Ctrl+X the whole current line when nothing is selected in the editor.
Render special characters, such as control codes, using their Unicode name abbreviations
When this option is selected, you can use the Unicode name abbreviations for special characters, such as control codes.
Show zoom indicator
Use this option to see an indicator that shows the current font size and the option to revert it back to default while zooming your code in or out in the editor.
Tab character rendering
You can select one of the following options:
Left margin in distraction free mode
This option lets you adjust the left editor margin in the distraction-free and zen viewing modes.
By default, the editor text in these viewing modes is centered vertically and the text column width corresponds to the Hard wrap at option on the Editor | Code Style page of the IDE settings Ctrl+Alt+S. This means that if your code will be centered when formatted properly, but if there are long unwrapped lines, the text might go beyond the viewport while there is a large margin on the left. In such cases, you may want to decrease the left margin using this option.
Force soft wrap in documents with lines longer than
The default number is
Move caret down after Comment with Line Comment action
This option lets you configure whether to move the caret to the next line if you comment a line with a line comment Ctrl+/. Note that if there is a selection in the editor, the caret will not move regardless of this option.
When navigating to a file, prefer selecting existing tab in inactive split pane
When you navigate to a file that is already opened in the inactive split, use this option to activate the existing file in that split pane instead of opening a new copy of the file in the active split.
Open declaration source in the same tab
When you navigate to a method, class or variable, the source file that contains their declaration will replace the current tab if there are no changes.
Open declaration source called from a detached window in the main IDE window
When you navigate to a method, class, or variable from a detached window, PyCharm will open the source file containing the declaration in the main editor.
Perform 'Hide All Tool Windows' / 'Restore Windows' with double-click on editor tab
When this option is enabled, you can double-click editor tabs to hide and restore all tool windows. Alternatively, you can do that by pressing Ctrl+Shift+F12 or by choosing from the main menu.
Perform 'Maximize Editor' / 'Normalize Splits' with double-click on editor tab
When this option is enabled, you can double-click tabs in split editor tab groups to change relative size of the tab group: the first double-click will extend the tab and its group to the maximum and shrink all other groups to the minimum width/height; the second double-click will allocate the same width and height for each tab group.
Alternatively, you can choose Find Action popup Ctrl+Shift+A.from the main menu or pick these actions from the
This option can work together with Perform 'Hide All Tool Windows' / 'Restore Windows' with double-click on editor tab, but be prepared to have multiple changes in the IDE layout every time you double-click a fie tab.
Equalize proportions in nested splits
Use this option to even the size of multiple horizontal or vertical splits in the editor.
Find / Replace
Use this section to configure extra options when working with Search and replace a target within a project.
Maximum number of results to show in Find in Files/Show Usages preview
The default maximum number of results is
Use this section to configure extra options on storing different entities of your project.
Maximum number of recent projects
Use this option to change the default number of stored recent projects, which is
Maximum number of recent files
Use this option to change the default number of stored recent files, which is
Maximum number of recent locations
Use this option to change the default number of stored recent locations, which is
Duration of storing changes in Local History
Use this option to specify the number of days for which you want to keep changes in the local history.
Hide floating toolbar
When you select some text in a Markdown file, PyCharm shows a floating toolbar with various formatting options. Select this checkbox if you don't want to see the floating toolbar, then reopen the tab to apply the changes.
Use this section to configure additional options for working in Project tool window.
Move focus to editor when Enter is pressed
When this option is selected, you can press Enter while in the Project view to switch focus to the editor.
When collapsing a node, also collapse all expanded nodes under it
When this option is selected, PyCharm collapses subnodes as well as the parent node.
Increase font size in Project view
Select this option if you want to change the size of font in the Project view. You need to restart PyCharm.
Swap the order of actual and expected assertions in Pytest
By default, PyCharm provides the
Pytest: do not add "--no-header --no-summary -q"
Use this checkbox to manage the test output generated by pytest. Select it to keep rendering the header and summary.
Temporary configurations limit
Use this option to change the default number of stored temporary run/debug configurations, which is
Confirm rerun with process termination
When you call rerun for a running process, PyCharm prompts you to confirm the action of terminating the existing process and launching a new one. You can change the default behaviour by clearing this checkbox.
Make configurations pinned by default
Select this option to automatically pin tabs that open in the Run tool window after you run configurations.
Configuration files parser
Select a parser:
Custom path to an OpenSSH tool
Specify the path to OpenSSH if you have selected the OpenSSH parser.
Show text search results in Search Everywhere
Enable text search in Search Everywhere. Results will be displayed on the new Text tab and on the All tab at the bottom of the list.
Sort results in the Actions tab based on machine learning
Sort search results on the Actions tab using machine learning instead of the standard ranking mechanism.
Sort results in the Files tab based on machine learning
Sort search results on the Files tab using machine learning instead of the standard ranking mechanism.
Open README.md file if there are no open files on project startup
If you select this option, PyCharm will open a README.md file if there aren't any opened files when you start your project.
Terminal scrollback buffer size
Use this option to increase the buffer size in the terminal.
Move focus to the editor with Escape
When this option is selected, you can use Escape to switch focus from the terminal to the editor.
Enable typeahead in the terminal, which can be useful for remote connections when you expect the typing latency.
Typeahead latency threshold
Turn typeahead on when the terminal latency exceeds the specified value (in milliseconds).
Show application title
Name terminal tabs automatically based on the commands that you run.
Tests Indexing Task
Show indexing of tests as background task
You can monitor and pause/cancel test indexing as any other background task in the Progress bar. This option is enabled by default.
Show tests indexing as a background task after a specified timeout in milliseconds
This option sets the amount time after which test indexing will appear in the Progress bar as a background task.
Show file type icon in IDE frame header
On macOS, the icon can be used to drag a file to a different application.
Use words instead of symbols for macOS keyboard shortcuts
Select this option if you want to see shortcuts with words instead of symbols.
Cyclic scrolling in lists and trees
Select the last element when pressing Up on the first element, and vice versa.
Position mouse cursor on default button in dialogs
When this option is selected, the mouse cursor is placed on the default button (usually it is OK) in a dialog.
Disable double modifier key shortcuts
You can disable shortcuts where a double key is used. For example, Shift or Ctrl.
Open Diff as Editor Tab
When this option is selected, the difference viewer is displayed as the editor tab.
Load file annotations from VCS when file is opened in editor
When this option is selected, PyCharm loads annotations when you open a file in the editor.
Highlight ignored files
When this option is selected, PyCharm shows the list of ignored files from VCS and displays their status in the editor.
Enable Commit tool window
When you select this option, PyCharm displays the Local Changes and Shelf tabs in a separate tool window.
Toggle commit controls
When this option is selected, PyCharm hides the commit panel and checkboxes after the commit is performed and lets you toggle them in the Commit Changes dialog.
Select all repositories with new commits for push
When this option is selected, PyCharm selects all commits that will be pushed by default.
Version Control. Git
Recursively clone submodules in the project
When this option is selected, during the checkout from Git,
Apply content transformation when reading from Git
When this option is selected, PyCharm will use the
Use Safe Force Push
When this option is selected, PyCharm uses
Check for incoming and outgoing commits
When this option is selected, PyCharm updates the information on the branches that have incoming or outgoing commits in the Branches popup.
Use Windows certificate store
When this option is selected, it forces Git to use Windows certificate store to verify SSL connections. This works for Git 2.14 and later versions.