Directory Mappings

Directory

This field shows the path to project directories or the project roots.

For projects with Git integration enabled, PyCharm scans project directories to check if there are Git repositories that are not controlled by the IDE. If such repositories are found, they are listed here under Unregistered roots and are marked grey. To add an unregistered root, select it in the list and click the Add button .

PyCharm also checks if registered roots are valid, in other words, that a Git repository exists at the specified path. If invalid repositories are detected, they are marked with red.

VCS

Select a version control system for the specified directory.

VCS integration in PyCharm is provided through a set of bundled plugins enabled by default. So the list only displays the version control systems which plugins are enabled.

Click this button to add a directory mapping to the list. The Add VCS Directory Mapping dialog opens where you can specify the required directory, select a VCS for it, and open the Version Control Configurations dialog to configure the specified VCS, if necessary.

Click this button to edit the selected directory mapping. The Edit VCS Directory Mapping dialog opens where you can update the selected mapping and configure the specified VCS, if necessary.

Click this button to remove the selected directory mapping from the list.