Breadcrumbs

Creating your first branch

Awesome! You are ready to try Page Branching. Follow these steps to create and merge your first branch on Confluence Cloud.

1. Pick a page to branch

Open any Confluence page in a space where Page Branching is enabled. You need permission to create and edit pages in that space.

📷 Screenshot needed: A regular Confluence page in view mode, with the Page Branching byline visible below the page title.

2. Create the branch

  1. Make sure you are in view mode (not the editor).

  2. Below the page title, open the Page Branching byline.

  3. Click Create branch.

  4. Enter a clear branch name (for example draft-q2-update) and confirm.

📷 Screenshot needed: The Create branch dialog with a branch name like draft-q2-update typed in and the primary action button highlighted.

Confluence opens your new branch page. It starts as a copy of the original page body. Edit the branch freely – the original page stays unchanged.

3. Edit the branch

Click Edit and change the branch content. When you save, only the branch is updated.

Check the byline on the branch page: it shows whether your branch is up to date with the original. If someone edits the original while you work on the branch, use Update (sync) from the byline before merging.

📷 Screenshot needed: A branch page in view mode showing the byline with branch name, status indicator (e.g. Up to date or Outdated) and the actions menu open (Update, Merge, Diff, Delete).

4. Merge back to the original

  1. From the branch byline, click Merge.

  2. Review the confirmation and complete the merge.

📷 Screenshot needed: The merge confirmation dialog on a branch page, with the Merge button visible.

Your changes are applied to the original page. Depending on space settings, the branch is archived under Branches or deleted after merge. You did it! 🎉

5. What if merge is blocked?

If the original page and the branch both changed the same content, Page Branching may report a merge conflict. Don’t worry – see Merge Conflicts for how to update the branch and merge successfully.

Next steps