Git

Tags Commands

Mark important points in your repository's history with tags. Learn to create lightweight and annotated tags, manage releases, and use semantic versioning effectively.

9 commands

Pro Tips

Use annotated tags ('git tag -a') for releases - they include metadata like author, date, and message.

Follow semantic versioning (v1.2.3) for release tags: major.minor.patch makes version history clear.

Tags must be pushed explicitly with 'git push --tags' or 'git push origin tag-name'.

Common Mistakes

Avoid moving tags after they've been pushed - other developers may have referenced the old commit.

Deleting remote tags requires 'git push --delete origin tagname' - local deletion doesn't affect remote.

Commands

List tags

$ git tag

List all tags.

Create lightweight tag

$ git tag <tagname>

Create a simple tag.

Create annotated tag

$ git tag -a <tagname> -m "message"

Create tag with message.

Create signed tag

$ git tag -s <tagname> -m "message"

Create GPG-signed tag.

Tag specific commit

$ git tag <tagname> <commit>

Tag a specific commit.

Delete local tag

$ git tag -d <tagname>

Remove a local tag.

Delete remote tag

$ git push origin :refs/tags/<tagname>

Remove tag from remote.

Push single tag

$ git push origin <tagname>

Push specific tag to remote.

Checkout tag

$ git checkout tags/<tagname>

Checkout a specific tag.

Git