gresb/Git Tag

Create a git tag or read tag information from a comment.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit May 1, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: gresb/action-git-tag@657a85e339f3611136864c3ee2c3f861f82a0b52 # v1.14.0

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
create	Whether to create a tag comment.	yes	""
read	Whether to read a tag comment.	yes	""
pr-number	If the action is running on a PR event, this input defines the PR number and the tag will be read from a PR comment. This input should not be set together with "ref".	no	""
ref	If the action is running on a tag event, this input defined the tag ref (eg. github.ref) and the tag will be read from the ref. This input should not be set together with "pr-number".	no	""
release-candidate-suffix	If the action is running on a PR, this input defines git tag suffix for the release candidate tag.	no	rc
tag-comment-header	The header on the tag comment, used to create the comment and to find existing comments.	no	## Tag created
tag-comment-body	Markdown content to be appended to the body of the tag comment.	no	""
workflow-run-url	The url of the workflow run.	no	${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
github-token	The GitHub token used for creating the tag.	yes	—

Outputs

name	description
tag	The name of the tag.
is-final	Whether the release is a final release (eg v1.2.3).
sha	The sha of the tagged commit.
pr-number	The PR number referenced in release candidate tags.