Lightweight vs annotated tags in Git - Visual Side-by-Side Comparison

Process Flow - Lightweight vs annotated tags

Start: Create Tag

↓

Choose Tag Type

↓

Lightweight

↓

Simple ref

↓

Tag Created

↓

Use Tag in Git Operations

This flow shows how creating a tag splits into two types: lightweight tags are simple pointers, annotated tags store extra info like author and message.

Execution Sample

Git

git tag v1.0

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

Create a lightweight tag named v1.0 and an annotated tag named v1.0 with a message.

Process Table

Step	Command	Action	Tag Type	Tag Details	Result
1	git tag v1.0	Create tag named v1.0	Lightweight	No message, no author	Tag 'v1.0' created as simple pointer
2	git tag -a v1.0 -m "Release version 1.0"	Create annotated tag named v1.0	Annotated	Includes message and author info	Tag 'v1.0' created with annotation
3	git show v1.0 (lightweight)	Show tag details	Lightweight	Shows pointed-to commit details (no tag metadata)	Displays the commit details
4	git show v1.0 (annotated)	Show tag details	Annotated	Shows commit hash, tagger, date, message	Displays full annotation info
5	git push origin v1.0	Push tag to remote	Both	Tag is pushed to remote repository	Tag available on remote
6	Exit	No more commands	-	-	End of tag creation and inspection

💡 All tags created and inspected; process ends.

Status Tracker

Variable	Start	After Step 1	After Step 2	Final
Tag 'v1.0'	None	Lightweight tag created (pointer to commit)	Annotated tag created (pointer + metadata)	Annotated tag exists with full info

Key Moments - 3 Insights

Why does 'git show' on a lightweight tag not show tagger or message?

Because lightweight tags are just simple pointers to commits without extra tag data like tagger or message. It shows the commit details instead, as shown in execution_table step 3.

What extra information does an annotated tag store compared to a lightweight tag?

Annotated tags store the tagger's name, date, and a message, visible in execution_table step 4.

Can both lightweight and annotated tags be pushed to a remote repository?

Yes, both types can be pushed as shown in execution_table step 5.

Visual Quiz - 3 Questions

Look at the execution table, what does the command 'git tag v1.0' create?

A A lightweight tag as a simple pointer

B An annotated tag with message

C A branch named v1.0

D A commit with tag message

💡 Hint

See execution_table row 1 under 'Tag Type' and 'Result'

At which step does the tag include author and message information?

A Step 1

B Step 2

C Step 3

D Step 5

💡 Hint

Check execution_table row 2 under 'Tag Details'

If you run 'git show v1.0' on a lightweight tag, what will you see?

A Tagger name and date

B Commit hash and tag message

C The commit details (no tagger info)

D Nothing, error message

💡 Hint

Refer to execution_table row 3 under 'Tag Details' and 'Result'

Concept Snapshot

Lightweight tags are simple pointers to commits without extra info.
Annotated tags store metadata: tagger, date, message.
Create lightweight: git tag <name>
Create annotated: git tag -a <name> -m "message"
Both tags can be pushed to remote.
Use 'git show <tag>' to see details.

Full Transcript

This lesson shows the difference between lightweight and annotated tags in git. Lightweight tags are simple pointers to commits without extra data. Annotated tags include metadata like author, date, and a message. We create a lightweight tag with 'git tag v1.0' and an annotated tag with 'git tag -a v1.0 -m "Release version 1.0"'. Using 'git show' on a lightweight tag shows the commit it points to, while on an annotated tag it shows full details. Both tags can be pushed to a remote repository. This helps you mark important points in your project history with or without extra information.