Tag
Published Jun 30, 2022
Contribute to Docs
The tag command creates, lists, deletes, or verifies a commit marker with a GnuPG tag object attached. This helps add some semantic meaning to a commit message.
Syntax
git tag <flags> <tag-name> <commit-reference> <tag-object>
The <flags> include the following:
| Flag | Description |
|---|---|
-a/--annotate |
The tag is annotated but unsigned. |
-s/--sign |
The tag is annotated and signed with the key of the default email address. |
-f/--force |
An existing tag is forcibly replaced with a given <tag-name>. |
-d/--delete |
One or more existing tags are deleted by <tag-name>. |
-v/--verify |
One or more existing tags are verified by <tag-name>. |
-l/--list |
All existing tags are listed (same as running just git tag). |
-m/--message |
A message for an existing tag is defined instead of prompted. Multiple -m messages can be used, but they will combined as separate paragraphs. |
-F/--file |
A tag message from an existing file is read from the standard input. |
-e/--edit |
A tag message made from -m or -F is edited. |
The <tag-name> refers to the tag object for a commit.
The <commit-reference> is the commit the tag will be attached to.
The <tag-object> is usually the commit that the new tag refers to (defaults to the HEAD) pointer.
Example
The following is a small example of the tag command being used to create and annotate an object for the HEAD commit pointer:
git tag -a tag-for-head-pointer
Contribute to Docs
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.
