How do I manage project branches?

Initial steps:

  1. Visit your project page.
  2. Click Edit.

    Next to the Branches label, a drop-down button for each branch is displayed, plus an Add Branch button.

    Branches drop-down image

Adding a branch

  1. Follow the initial steps.
  2. Click Add Branch. The branch drop-down dialog opens.

    Branch drop-down dialog image

  3. In the Name field, enter a short name for your branch.
  4. In the Paths field, enter one or more branch paths, one per line.


    Each branch path should be expressed in depot syntax. Wildcards should not be used; the only exception is the branch path can end with the Helix Core wildcard ...

    For example: //depot/main/swarm/...

    For more information, see File Specifications in P4 Command Reference.

  5. Optionally, check the Only Moderators can approve or reject reviews checkbox.

    When checked, a field is displayed, allowing you to add a new moderator. The field auto-suggests groups and users within the Helix Versioning Engine as you type.

    If a group is specified as a moderator, all of the members of that group have the same moderator privileges for that project branch as if they were added individually.

    Once the branch specification is complete and the project has been saved, changing the state of any review associated with this moderated branch is restricted as follows:

  6. Click Done to accept your branch specification.

    Once the branch definition has completed, if any moderators were specified, the number of moderators for that branch is displayed in the list of branches.

  7. Click Save to save the branch changes to your project.

The project name does not need to be included in the branch name; Swarm displays the project name with the branch name when appropriate.

Editing a branch

  1. Follow the initial steps.
  2. Click the branch drop-down button you want to edit.
  3. Revise the Name, Paths, or moderators as required.
  4. Click Save.

Removing a branch

  1. Follow the initial steps.
  2. Click the branch drop-down button you want to remove.
  3. Click Remove.
  4. Click Save.