WebStorm 2016.1 Help

Associating a Directory with a Specific Version Control System

WebStorm supports a directory-based versioning model, which means that each project directory can be associated with a different version control system.

Associating a directory with a version control system

To associate a directory with a version control system, follow these steps:

  1. Open version control settings (File | Settings | Version Control). This page shows a list of project directories and version control systems associated with them (if no directories have been added, the list only contains the project root).
  2. Click the Add button add on the right.
  3. In the Add VCS Directory Mapping dialog box that opens, select the Directory option. Type the path to the directory that you want to associate with a version control system, or click the Browse button browseButton and select the directory in the dialog that opens.
  4. From the VCS drop-down list, select the version control system that will be used to control the files in this directory. Note that this list only contains the version control systems for which the corresponding Plugins are currently enabled (see Managing Plugins for details).
  5. Optionally, click the Configure VCS button that allows you to specify the settings for the selected version control system. The same settings are also available under the Version Control settings node.
  6. Click OK to save the mapping and return to the Version Control page.

Managing unregistered directories

For projects with Git or Mercurial integration enabled, WebStorm scans project directories to check if there are Git/Mercurial repositories that are not controlled by the IDE. If such repositories are detected, WebStorm displays a notification.

To add an unregistered root, click the Add roots link in the notification. Alternatively, open the Version Control settings page, select the unregistered root you want to add (they are marked grey) and follow the procedure Associating a Directory with a Specific Version Control System.

If you do not want to be notified about these roots again, click the Ignore link in the notification. Note that if new unregistered repositories are added to the project, WebStorm will notify you about them.

See Also

Last modified: 11 July 2016