Adding, Moving, and Removing Tags in SourceTree

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

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 perform basic Tag functions with SourceTree.

Solution

This page:

Access the Tag Menu

To access the tag function, simply click on the Tag button at the top menu:

(Auto-migrated image: description temporarily unavailable)

Or, you can right-click the sidebar, and then click on New Tag...:

(Auto-migrated image: description temporarily unavailable)

Add a new tag

Clicking on Tag at the top menu, or clicking New Tag... by right-clicking at the sidebar will trigger this window to pop up:

(Auto-migrated image: description temporarily unavailable)

Fill in the necessary details. You can either add it on the parent commit, or you can specify which commit to add the tag on.

To create a lightweight tag instead of the default annotated tag:

  1. In the Tag window, Click on the Advanced Options

  2. Then, check on Lightweight tag

To know more about Lightweight tag, read here: https://git-scm.com/book/en/v2/Git-Basics-Tagging#Lightweight-Tags

The end-result should look like this:

(Auto-migrated image: description temporarily unavailable)

The Tags section at the sidebar should be filled, and the tag will also appear on the commit description.

Removing a tag

Clicking on Tag at the top menu will trigger this window to pop up; select Remove Tag. Select a tag to remove:

(Auto-migrated image: description temporarily unavailable)

You can also trigger the window to appear by right-clicking a tag at the sidebar, and select Delete <tag_name>:

(Auto-migrated image: description temporarily unavailable)

Moving a tag

To move a tag from a commit to another:

1. In the Tag Name column, type an existing tag you'll like to move.

2. Under Advanced Options, check the box that says "Move existing tag". Specify the commit you would like to move to by clicking the button (the arrow is pointing to) below.:

(Auto-migrated image: description temporarily unavailable)

3. Select your commit. Click OK:

(Auto-migrated image: description temporarily unavailable)

4. Click Add Tag.

If you did not check "Move existing tag" under Advanced Opttions, a popup window should appear. Click Move Tag:

(Auto-migrated image: description temporarily unavailable)

5. You'll now see that the tag has now moved:

(Auto-migrated image: description temporarily unavailable)
Updated on April 15, 2025

Still need help?

The Atlassian Community is here for you.