Projects

Projects group users and code into a shared workspace in P4 Code Review. Use projects to collaborate on one or more code lines in P4 Server.

A project includes:

For details about managing projects, see Projects.

Listing projects

View projects from the Projects page.

  • Click Projects in the main menu

  • Select:

    • All Projects to view all available projects.

    • My Projects to view projects you own or are a member of.

Anonymous users can only see public projects

Project indicators

  • A number next to the project name shows the number of members

  • The Project Owner icon Project Owner Icon image indicates projects you own

  • The Private Project icon Image of the Private Project icon indicates restricted visibility. To learn more, see Private projects.

Search project

Search for projects by name or description:

  1. Enter text in the search box.
  2. Click Search.

Matching results are displayed in the current tab. Switch tabs to view results in other project lists.

Viewing a project

Open a project in one of the following ways:

  • Click the project name on the Projects page

  • Click a project name or branch link in an activity stream.
  • Open the project URL: https://<swarm-url>/projects/<project-name>.

Project pages

Each project contains several tabs.

Overview page

The project Overview page shows a description of the project.

The sidebar includes:

  • Project description

  • Follow button (not shown for members)

  • Project owners

  • Project moderators

  • Project members

  • Project followers

  • Project branches

Hover over a branch name to view the moderators on that branch.

Activity page

The Activity page shows the project activity stream.

The sidebar shows the same project information as the Overview page.

Reviews page

The Reviews page lists all reviews associated with the project.

For more information, see Reviews list

Files page

The Files page shows project files organized by branch.

  • Each branch is displayed as a folder.

  • The main branch (for example: main, mainline, trunk) is shown at the top and highlighted. Branches are designated with the branch icon Branch icon image.

Branch naming for the mainline can be configured.

To learn more on browsing files, see Files.

Commits page

The Commits page shows all changes for the project.

To learn more, see Commits.

Jobs page

The Jobs page lists jobs associated with the project. This page is only displayed if a job filter is configured. To learn more, see Job filter. For more details on browsing and searching jobs, see Jobs.

Settings page

The Settings page displays and manages project configuration. Open the Branches tab and select a branch to view the moderators on that branch.

To learn more about project settings, see Configure a project.

Private projects

Private projects restrict visibility of project data and activity.

When a project is private, only the following users can see it:

  • Project owners

  • Project moderators

  • Project members

  • Users with super privileges

Private projects are identified by an eye icon.

Image of a Private Project in the Projects page

Important behavior

Private projects limit visibility, but they do not override P4 Server protections.

  • Users with access to depot paths can still view files and changes directly in the depot.

  • Use P4 Server protections to restrict file access if required.

Reviews and private projects

  • Users can create reviews that include files from private projects.

  • Users who are not project members, owners, moderators, or do not have super privileges cannot participate in those reviews.

If a user is added to a review but does not have access (for example, via an Links in descriptions and comments in a description or comment, or by being added as a participant):

  • They cannot view the review, its files, or its comments.

  • They might still receive email notifications due to system limitations.

Notifications for private projects are filtered to remove references to those projects.