Add files to a local Mercurial repository

After a Mercurial repository for a project is initialized, you need to add the project data to it:

If you have specified enabled Mercurial for your project, PhpStorm suggests putting each new file under Mercurial control during the file creation.
You can add all unversioned files to Mercurial control or select files to add.

Add all unversioned files to Mercurial

Open the Commit tool window Alt+0.
Right-click the Unversioned Files node and choose Add to VCS from the context menu.
Click Commit or press Command K.

Add specific file(s) to Mercurial

Open the Commit tool window Alt+0.
Expand the Unversioned Files node, select the files to be added. From the context menu, choose Add to VCS.
You can also add files to VCS from the Project tool window (Alt+1): right-click the files that you want to add and select Mercurial | Add.
Click Commit or press Command K.

Specify the commit options

In PhpStorm, you can run commit checks, upload files to a server after the commit, or commit with advanced options.

Open the Commit tool window Alt+0 and click in the bottom-right corner.
Select the necessary options:
- In the Commit Checks area, select the actions you want PhpStorm to perform while committing the selected files to the local repository.
  The following options are available:
  - Reformat code: perform code formatting according to the Project Code Style settings.
  - Rearrange code: rearrange your code according to the arrangement rules preferences.
  - Optimize imports: remove redundant import statements.
  - Analyze code: analyze modified files while committing them. Click Choose profile to select an inspection profile from which the IDE will run inspections.
  - Check TODO (<filter name>): Review the TODO items matching the specified filter. Click Configure to choose an existing TODO filter, or open the TODO settings page and define a new filter to be applied.
  - Cleanup: batch-apply quick-fixes from code cleanup inspections. Click Choose profile to select a profile from which the IDE will run inspections.
  - Run Tests: run tests as commit checks. Click Choose configuration near Run Tests and select which configuration you want to run.
  - Update copyright: add or update a copyright notice according to the selected copyright profile - scope combination.
- In the After Commit area, you can select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory. For more information, refer to Deploy your application.
  The following options are available:
  - Run tool: select the external tool that you want PhpStorm to launch after the selected changes have been committed. You can select a tool from the list, or click the Browse button and configure an external tool in the External Tools dialog that opens.
  - Upload files to: select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory.
    - To suppress uploading, choose None.
    - To add a server configuration to the list, click and fill in the required fields in the Add Server dialog that opens.
    The list is only available if the FTP/SFTP/WebDAV Connectivity plugin is enabled.
  - Always use selected server or group of servers: always upload files to the selected server or a server group.
    The checkbox is only available if the FTP/SFTP/WebDAV Connectivity plugin is enabled.

Last modified: 23 August 2023