Use Git tags

You can view tags in the Tags view and in the Commits view in the web portal.

View tags in the Tags view

1. To view the tags in your repo, navigate to your project in the web portal, choose Repos, Tags, and select the desired repo.

   

   Annotated tags are displayed with a tag name, message, commit, tagger, and creation date. Lightweight tags are displayed with a tag name and commit.

2. To filter the list of tags, type a search term into the Search tag name box and press Enter.

   

View tags in the Commits view

To view tags for a specific branch in the Commits view, navigate to your repo in the web portal, choose Repos, Commits, and select your branch.

View tags in the History view

You can view tags in the History view.

1. From the Git menu in the menu bar, select Manage Branches.

2. To view history, select a branch.

   

   The red shapes are branches, and the green shapes are tags.

View tags in the Tags view

1. To view all tags in a repo, select Tags from the Home view.

   

2. Tags are displayed under the currently connected repo name.

   

   Annotated tags display a tooltip that contains the tag name, tagger, tag date, and message. Lightweight tags have only the tag name in the tooltip.

   

   For more information about the tagged commit, right-click the tag and select View Commit Details.

   

3. To filter the list of tags, type a search term into the Type here to filter the list box.

   

To retrieve the current list of tags from the source repo, perform a fetch operation.

You can create annotated tags using the web portal from both the Tags view and the Commits view.

Create tags from the Tags view

1. Select Create tag from the Tags view in the web portal to create a new annotated tag.

   

2. Specify a Name, select the branch to Tag from, enter a Description (required since you're creating an annotated tag), and select Create.

   

3. The new tag is displayed in the tag list.

   

Create tags from the Commits view

To create a tag directly from the commits view, right-click the desired tag and choose Create tag.

You can create both annotated and lightweight tags in Visual Studio from both the History view and the Tags view. To create an annotated tag, provide both a name and a message when creating the tag. To create a lightweight tag, omit the message and supply only a name.

Create tags from the History view

You can view tags in the History view.

1. From the Git menu in the menu bar, select Manage Branches.

2. Select a branch to view history, right-click a commit, and select New Tag.

   

3. In the Create a new tag dialog, enter a Tag name only for a lightweight tag or a Tag name and Tag message for an annotated tag. Select Create.

Create tags from the Tags view

1. Select New Tag in the Tags view to create a new tag.

   

2. To create a tag against the tip of the current branch, specify a name in the Enter a tag name box, optionally provide a tag message, and select Create tag.

   

   To select the branch to create the tag from, clear the Create tag against tip of current branch check box, and select a branch from the Select a branch drop-down.

   

3. The new tag is created locally. Right-click the new tag and choose Push to push it to the remote repo. Select Push All to push all new local tags to the remote repo.

   

Delete a tag in the remote repo

The steps in this procedure show you how to delete a tag in the remote repo using the Azure DevOps Services web portal.

1. To delete a tag, select the ellipsis to the right of the tag name and choose Delete tag.

   

2. Select Delete to confirm.

   

3. The tag is deleted, and won't be displayed the next time you navigate to the Tags view.

   

The steps in this procedure show you how to delete a tag in the local repo using Visual Studio 2019 Team Explorer.

Right-click the tag to delete and choose Delete Locally

1. To create a branch from a tag, select the ellipsis to the right of the tag name and choose New branch.

   

2. Specify a Name, optionally select any Work items to link, and choose Create branch.

   

3. The branch is created and you're taken to the new branch in the web portal.

   

The steps in this procedure show you how to create a branch from a tag using Visual Studio 2019 Team Explorer. For Visual Studio 2019 using the Git menu or Visual Studio 2022, use the browser.

1. To create a branch from a tag, right-click the tag and choose New Local Branch From. You can also choose Create Branch From Tag.

   

2. Specify a branch name, verify the desired tag, and choose Create Branch. To check out the new branch, choose Checkout branch.

   

3. To view your newly created branch, select Branches from the Home view.

   

4. Your new branch is created locally. To push the branch, right-click it and choose Push Branch.

   

1. To view the history for a tag, select the ellipsis to the right of the tag name and choose View history.

   

2. You're taken to the commits view for the tag.

   

The steps in this procedure show you how to view tag history using Visual Studio 2019 Team Explorer. For Visual Studio 2019 using the Git menu or Visual Studio 2022, use the browser.

1. To view the history for a tag, right-click the tag and choose View History.

   

2. The history is displayed in the History view.