Create and manage projects

Create projects to organize depot paths, workflows, and review rules. After a project is created, you can update its configuration or remove it when it is no longer needed.

Create a project

To learn how to create a project in P4 Code Review, watch this video or review the instructions following the video.

To create a project:

  1. On the Projects page, click the Add Project.

  2. Enter a name for the project and click Create.

The project is created but requires further configuration. Configure the project using the following tabs in the project settings page

  • Participants - Assign members, owners and default reviewers to a project.

  • Branches - Map depot paths to the project and control which files appear in reviews.

  • Integrations - Configure automated tests and deployment integrations for the project.

  • General settings - Assign workflows, set the minimum number of up votes, and control project type (open or private).

The ability to create projects can be restricted to administrators or specific user groups. When restricted, users without permission do not see the Add Project button.

Edit a project

To edit a project:

  1. Open the project you want to update.

  2. Click Settings in the project menu.

  3. Update the project configuration as required.

By default, any project member can edit project configuration. Administrators can restrict changes to the project name and branch definitions. To learn more, see Membership.

If a workflow is no longer shared, it remains associated with existing projects and branches. If you remove it, you cannot reselect it unless you own that workflow.

Delete a project

To delete a project:

  • Open the project you want to delete.

  • Click Settings and select the General settings tab.

  • Click Delete.

  • Confirm the deletion.

Delete permissions

  • Users with admin or super privileges can delete projects.

  • Project owners can delete their own projects.

  • If a project has no owner, any project member can delete it.

What happens when a project is deleted

When a project is deleted:

  • The project is removed from the project list and search results.

  • The project is removed from user profiles.

  • The project name is removed from the Reviews list.

Reviews associated with the project are not deleted:

  • Open and closed reviews remain accessible.

  • Comments, tasks, and review states are unchanged.

  • Project links in reviews are replaced with links to the associated depot paths.

Deleted project names cannot be reused, even with different letter casing.

Project ownership changes

If a project owner is removed from P4 Server:

  • If multiple owners exist, ownership remains with the remaining owners.

  • If one owner exists and there are project members, ownership is transferred to P4 Code Review.

  • If one owner exists and there are no members, the project is deleted.