GitKraken Desktop Documentation

Manage Git Tags in GitKraken Desktop

Last updated: January 2026

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.
GitKraken Desktop context menu on a commit with options to create tag or annotated tag
Create a tag from a commit’s context menu

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

GitKraken Desktop tag context menu showing push, merge, rebase, and delete options
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.

GitKraken Desktop context menu for a tag with options to push, merge, rebase, create branch, and delete
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.
GitKraken Desktop tag context menu showing options to push, merge, rebase, create branch, and more. The `create a branch` option is selected.
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.

GitKraken Desktop interface showing a hover tooltip for the annotated Git tag v1.9.0 in the Commit Graph
Hover to preview an annotated tag

Delete a Tag

To delete a tag locally:

  1. Right-click the tag in the Left Panel or Commit Graph.
  2. Select Delete [tag name] locally.
  3. Confirm by clicking Delete.

To delete a tag from the remote:

  1. Right-click the tag in the Left Panel or Commit Graph.
  2. Select Delete [tag name] from [remote].
  3. Confirm by clicking Delete

Deleting a tag is permanent and cannot be undone.

GitKraken Desktop context menu showing options to delete a Git tag locally or from the origin remote
Right-click a tag to delete it locally or from a remote.

Rename a Tag

GitKraken Desktop does not support renaming tags directly. To rename a tag, delete the existing one and create a new tag with the desired name.

  1. Right-click the tag in the Left Panel or Commit Graph.
  2. Select Delete [tag name] locally.
  3. If the tag also exists on a remote, right-click it again and select Delete [tag name] from [remote].
  4. Right-click the commit where you want to place the tag.
  5. Select Create tag here and enter the new name.

This workaround reflects Git’s limitations—Git tags are immutable once created.


Search or Filter Tags

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

GitKraken Desktop interface showing filtered Git tags matching '20160' under the 'translation' category in the left panel
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.
GitKraken Desktop interface with a dropdown menu showing toggles for Left Panel sections such as Remote, Pull Requests, Tags, and GitHub Actions
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