Skip to content

Tag

In one line

A tag is a named pointer to a specific commit, typically used to mark release versions like v1.0.0.

In simple words

A tag is a human-readable name attached to a specific commit, like a bookmark in history. Tags are most commonly used to mark release points: v1.0.0, v2.1.3, v1.0-beta.

There are two types of tags: lightweight (just a pointer, like a branch that does not move) and annotated (stores a message, tagger name, email, and date). Annotated tags are recommended for releases because they carry metadata and are GPG-signable.

Unlike branches, tags do not move — they always point to the same commit. Tags are not pushed by default with git push; you must explicitly push them with git push origin <tag> or git push --tags.

Example

bash
# Create an annotated tag
git tag -a v1.0.0 -m "First stable release"

# List all tags
git tag

# Push a specific tag
git push origin v1.0.0

Tags mark release points. Annotated tags carry metadata.

Related terms

Related Resources

Related Lessons

Decode error messages

Plain-English explanations of common errors — what they mean, why they happen, and how to fix them.

View errors

← Back to glossary