Branch Management

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

This article should help users to Create/Delete a branch, Checkout/Merge a branch, Track remote branch and use Git Flow.

Solution

This page:

Create Branch

(Auto-migrated image: description temporarily unavailable)

Steps:

  1. Click on the "Branch" button.

  2. Under the "New Branch" tab, fill in the Branch name.

  3. Click on "Create Branch".

Delete Branch

(Auto-migrated image: description temporarily unavailable)

Steps:

  1. Click on the "Branch" button.

  2. Click on "Delete Branches" tab.

  3. Check the branch or branches you intend to delete.

  4. Click on "Delete Branches".

If the branch is merged, you may check "Force delete regardless of merge status" and then click on "Delete Branches".

Checkout a Branch

There are two methods to checkout a branch in SourceTree.

(Auto-migrated image: description temporarily unavailable)

Method #1- Checking out a branch using the "Checkout" button.

Steps:

  1. Click on the "Checkout" button.

  2. Select the branch from the drop down menu.

  3. Click on "OK".

(Auto-migrated image: description temporarily unavailable)

Method #2- Checking out by double clicking on the Branch.

Steps:

  1. Double click on the branch you want to checkout.

Merge a Branch

(Auto-migrated image: description temporarily unavailable)

Steps:

  1. Make sure you check the branch you intend to merge another branch to.

  2. Click on the "Merge" button.

  3. Select the branch from the drop down menu.

  4. Click on "OK".

Tracking a remote Branch

(Auto-migrated image: description temporarily unavailable)

Steps:

  1. Right-click on a local branch.

  2. Click on "Track remote branch".

  3. Click on the branch you want to track.

Using Git Flow

Initialise Git Flow

(Auto-migrated image: description temporarily unavailable)

Steps:

  1. Click on the "Git Flow" button.

  2. Insert the name for the prefixes.

  3. Click on "OK".

Start new Feature

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Start New Feature".

  4. Enter the feature name which you intend to see as the prefix.

  5. Click on "OK".

Finish Feature

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Finish Feature"

  4. Choose the feature name from the drop down menu.

  5. Click on "OK".

Start New Release

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Start New Release"

  4. Enter the release name which you intend to see as the prefix.

  5. Click on "OK".

Finish Release

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Finish Release"

  4. Choose the release name from the drop down menu.

  5. Click on "OK".

Start New Hotfix

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Start New Hotfix"

  4. Enter the hotfix name which you intend to see as the prefix.

  5. Click on "OK".

Finish Hotfix

Steps:

  1. Click on "Repository" tab.

  2. Click on "Git Flow".

  3. Click on "Finish Hotfix"

  4. Choose the hotfix name from the drop down menu.

  5. Click on "OK".

Updated on April 15, 2025

Still need help?

The Atlassian Community is here for you.