Creating Branches

A branch is a working copy of a versioned application for making and testing changes. Creating a branch does not affect the live published version. When the changes are ready, publish the branch as a new version.

Create a Branch

Create a branch from any published version or from an existing branch.

To create a branch:

1. In the module toolbar, click the checkout pill.

   

2. Select Manage Versions.
3. Locate the source version or branch.
4. On that row, select (ellipsis) > Create Branch from [source].
5. In the Branch Name field, enter a name for the new branch.
6. Click Create Branch.

A confirmation message displays and the checkout pill switches to the new branch.

Branch Name Rules

Branch names must follow these rules:

• Maximum length: 25 characters
• Allowed characters: letters, numbers, hyphens, underscores, dots, and forward slashes
• Must begin with: a letter or number
• Cannot contain: two consecutive dots (..)
• Cannot end with: the string .lock

Working on a Branch

After switching to a branch, the checkout pill displays the branch name, and any edits to modules are saved to the branch without affecting published versions. Published versions and the default version are read-only, so switch to a branch before making changes.