Managing tags in GitHub Desktop

You can use GitHub Desktop to create, push, and view tags.

In this article

About tags in GitHub Desktop

GitHub Desktop allows you to create annotated tags. Tags are associated with commits, so you can use a tag to mark an individual point in your repository's history, including a version number for a release. For more information about release tags, see About releases.

By default, GitHub Desktop will push the tag that you create to your repository with the associated commit.

Creating a tag

  1. In the left sidebar, click History.

    Screenshot of the "History" tab in the sidebar. Above a list of commits, the tab button, labeled "History", is highlighted with an orange outline.

  2. Right-click the commit and click Create Tag....

    Screenshot of a list of commits in the "History" tab. Next to a commit, in a context menu, the cursor hovers over the "Create Tag" option.

  3. In the "Create a Tag" dialog window, type the name of the tag.

  4. Click Create Tag.

Viewing tags

  1. In the left sidebar, click History.

    Screenshot of the "History" tab in the sidebar. Above a list of commits, the tab button, labeled "History", is highlighted with an orange outline.

  2. Click the commit.

    Note

    GitHub Desktop displays an arrow if the tag has not been pushed to the remote repository.

    Screenshot of a list of commits in the "History" tab. Next to a commit, a "hello-tag" label and an "up arrow" icon are outlined in orange.

  3. All tags associated with the commit are visible in that commit's metadata.

    Screenshot of the detailed view of a commit. Above the commit's diff, in the commit's metadata, a tag icon and the label "hello-tag" are outlined in orange.

Deleting tags

Note

You can only delete tags associated with commits that have not yet been pushed.

  1. In the left sidebar, click History.

    Screenshot of the "History" tab in the sidebar. Above a list of commits, the tab button, labeled "History", is highlighted with an orange outline.

  2. Right-click the commit.

    • If a commit has only one tag, click Delete Tag TAG NAME.
      Screenshot of a list of commits in the "History" tab. Next to a commit, in a context menu, the cursor hovers over an option labeled "Delete tag hello-tag".
    • If a commit has multiple tags, hover over Delete Tag... and then click the tag that you want to delete.
      Screenshot of a context menu in the "History" tab. Next to "Delete tag", a second menu is expanded, and the cursor hovers over an option labeled "hello-tag".

Further reading