GitKraken Desktop Documentation

Tags

Tags are pointers to a commit. Some examples of these are for marking versions of your product or important changes.


Adding tags

To create a new tag in GitKraken Desktop, right-click on the commit you’d like to tag, and select Create tag here at the bottom.

Tags are created locally, but available for remotes by right-clicking the tag and selecting to push the tag to the remote.

Double-click a tag in the Left Panel to jump to when the tag was added. Tags can also be hidden and soloed just like branches from the context menu.


Checkout a tag

While you cannot directly checkout a tag, right-click on a tag and choose the Create branch here to create and then immediately checkout the commit tied with the tag.

Alternatively, consider using the detached HEAD state to checkout the commit directly.


Moving tags

To move a tag to the branch HEAD, checkout the new branch, right-click the tag, and select fast-forward.

If a tag cannot be fast-forwarded, you can delete and then add a new one. Be sure to delete the tag on remote as well.


Tag messages

Create annotated tags by right-clicking a branch or commit and selecting Create annotated tag here. You can annotate an existing tag by right-clicking the tag and selecting Annotate tag. This message will be displayed when hovering over the tag in the Left Panel, or in the Commit Graph.

Search or filter tags

You may filter tags from the filter bar in the Left Panel. Use this to quickly find a tag.

Hide or show Tags in Left Panel

All panes in the Left Panel can be toggled on or off by right-clicking on any pane header.

Check the panes you wish to see, and uncheck any panes you wish to hide.

Have feedback about this article? Did we miss something? Let us know!
On this page