Creating tags in Git - Step-by-Step CLI Walkthrough

Introduction

Tags in Git help you mark specific points in your project history as important, like marking a release version. This makes it easy to find and refer to those points later.

When you want to mark a stable version of your project before sharing it with others.

When you need to label a specific commit for a release or milestone.

When you want to easily switch back to a known good state of your code.

When you want to share a specific version of your code with your team or users.

When you want to keep track of versions without changing the main branch.

Commands

This command creates a lightweight tag named 'v1.0' on the latest commit to mark this point as version 1.0.

Terminal

git tag v1.0

Expected Output

No output (command runs silently)

This creates an annotated tag named 'v1.0' with a message describing the tag. Annotated tags store extra information like the tagger name and date.

Terminal

git tag -a v1.0 -m "Release version 1.0"

Expected Output

No output (command runs silently)

→

-a - Creates an annotated tag with metadata.

→

-m - Adds a message to the tag.

Lists all tags in the repository so you can see the tags you have created.

Terminal

git tag

Expected Output

v1.0

Shows details about the tag 'v1.0', including the commit it points to and the tag message if annotated.

Terminal

git show v1.0

Expected Output

tag v1.0

Tagger: Your Name <[e-mail]>

Date:   Thu Jun 1 12:00:00 2023 +0000



Release version 1.0



commit abc1234def5678

Author: Your Name <[e-mail]>

Date:   Thu Jun 1 11:50:00 2023 +0000



    Commit message for this version

Key Concept

If you remember nothing else from this pattern, remember: tags mark important points in your project history to easily find and share versions.

Common Mistakes

Creating a tag without the -a flag when you want to add a message.

Lightweight tags do not store messages or extra info, so you lose important context.

Use 'git tag -a <tagname> -m "message"' to create an annotated tag with a message.

Trying to create a tag with a name that already exists.

Git will not overwrite existing tags by default and will show an error.

Delete the old tag first with 'git tag -d <tagname>' or choose a new tag name.

Not pushing tags to the remote repository after creating them locally.

Tags stay only on your local machine and others cannot see them.

Use 'git push origin <tagname>' to share tags with others.

Summary

Use 'git tag <tagname>' to create a simple tag on the latest commit.

Use 'git tag -a <tagname> -m "message"' to create an annotated tag with extra info.

Use 'git tag' to list all tags in your repository.

Use 'git show <tagname>' to see details about a specific tag.