GitKraken Desktop Documentation

Tags

Last updated: May 2025

Tags are labels that point to a specific commit in your Git history. They’re useful for marking version releases or significant project milestones.


Add a Tag

To create a new tag:

  1. Right-click a commit.
  2. Select Create tag here.
Create a tag from a commit’s context menu

To share a tag with collaborators, right-click it and choose Push tag.

Push a local tag to a remote

Double-click a tag in the Left Panel to jump to that commit in the graph. You can also hide or solo tags via the context menu.

Access tag options from the Left Panel

Create a Branch from a Tag

While you can’t check out a tag directly, you can branch from it:

  1. Right-click the tag.
  2. Select Create branch here.
Create a branch from a tag

Alternatively, use the detached HEAD state to inspect a tagged commit.


Move a Tag

To move a tag to a new commit:

  1. Check out the new branch.
  2. Right-click the tag.
  3. Choose Fast-forward.

If fast-forwarding is not possible, delete the tag locally and remotely, then recreate it on the new commit.


Annotate a Tag

To add a message to a tag:

  • Right-click a commit and choose Create annotated tag here
  • Or right-click an existing tag and select Annotate tag

Annotated messages appear in the graph and Left Panel on hover.

Hover to preview an annotated tag

Search or Filter Tags

Use the filter bar in the Left Panel to search for tags.

Search for tags from the Left Panel

Show or Hide Tags Panel

To toggle visibility of the Tags section:

  • Right-click any header in the Left Panel
  • Check or uncheck Tags
Show or hide the Tags pane in the Left Panel
Have feedback about this article? Did we miss something? Let us know!
On this page