6.2Creating Tags

Lightweight Tags

A lightweight tag is just a pointer to a commit. It has no additional metadata.

# Create a lightweight tag
git tag v2.4.0

# Tag a specific commit (not HEAD)
git tag v2.4.0 abc123f

Annotated Tags (Recommended)

Annotated tags store the tagger's name, date, and a message. For releases, always use annotated tags.

# Create an annotated tag
git tag -a v2.4.0 -m "Release 2.4.0 - passed full regression suite"

# Create an annotated tag with detailed test information
git tag -a v2.4.0 -m "Release 2.4.0
Regression suite: 342/342 passed
Browser coverage: Chrome 120, Firefox 121, Safari 17
CI run: https://github.com/org/repo/actions/runs/12345
Known issues: SHOP-567 (low priority, cosmetic)"