PyCharm 2020.1 Help

Renaming Projects

In most cases, the name of a PyCharm project is the same as the name of its root folder, so the easiest way to change the name of a project is just rename its root folder.

In this case however you have to re-configure access to the server so that the server root is mapped to the new project root name. To avoid these additional steps, you can change the name of the project but have its root folder name preserved.

  1. Right-click the root folder of your project and select Refactor | Rename from the context menu or press Shift+F6.

  2. In the dialog that opens, choose the rename strategy.

    • If the project name is the same as the name of its root folder, select Rename directory.

      Renaming a directory
      PyCharm will perform the Rename refactoring so that all the references to the directory throughout the code remain valid.
      Preview of the rename refactoring

    • If the project name is different from the name of its root folder, select Rename project.

      Renaming a project

      Alternatively, select File | Rename Project from the main menu and type the new name of the project in the dialog that opens.

      Also select this option if your application is deployed to a remote server and the project root folder is mapped to the server root.

    Of course, you can rename the root folder and update the mapping in the server configuration accordingly, see Configure synchronization with a Web server for details.

Last modified: 6 July 2020