How to List Tags in Git

Q: How to List Tags in Git

To list all tags in a Git repository, run git tag, which prints them in alphabetical order. To filter tags by a pattern — for example all tags matching a version scheme — use git tag -l "v1.*" (the -l flag is required for wildcard patterns). To see each tag alongside the first line of its message (for annotated tags) or the referenced commit message (for lightweight tags), run git tag -n. For full details on a specific annotated tag — tagger name, date, and full message — use git show . To list remote tags without fetching them locally, run git ls-remote --tags origin, which shows the full ref path and commit hash for each tag on the server.

Run git tag with no arguments to list all tags in alphabetical order:

$ git tag

Filtering by Pattern

Use -l with a wildcard pattern to narrow the list. For example, to see only tags starting with v1.:

$ git tag -l "v1.*"

This would match v1.0, v1.1, v1.2, and so on.

Viewing What a Tag Points To

git tag only shows tag names. To see the full details — the commit it points to, the tagger, the date, and any tag message — use git show:

$ git show v1.0

What to Do with Your Tags?

Checkout a tag: View the state of your project at that point in time.
Delete a tag: Remove tags you no longer need.

Tip

Listing Tags in Tower

In the Tower Git client, you can easily view all of your tags in the sidebar. By right-clicking on any tag, you can perform multiple operations via the context menu.

Get our popular Git Cheat Sheet for free!

You'll find the most important commands on the front and helpful best practice tips on the back. Over 100,000 developers have downloaded it to make Git a little bit easier.

About Us

As the makers of Tower, the best Git client for Mac and Windows, we help over 100,000 users in companies like Apple, Google, Amazon, Twitter, and Ebay get the most out of Git.

Just like with Tower, our mission with this platform is to help people become better professionals.

That's why we provide our guides, videos, and cheat sheets (about version control with Git and lots of other topics) for free.