jimeh/update-tags-action

Easily create/update one or more tags in a GitHub repository.

Trust Signals

name	description	required	default
tags	List/CSV of tags to create/update. Supports per-tag ref and annotation overrides using the format 'tag:ref:annotation'. Use 'tag::annotation' to specify an annotation with the default ref.	no	—
derive_from	Semver version string to derive tags from (e.g., 'v1.2.3'). When provided, generates tags using `derive_from_template` input. Default template will produce major and minor tags. (e.g., 'v1', 'v1.2')	no	—
derive_from_template	Handlebars template for deriving tags from the `derive_from` input. Uses the same format as the `tags` input, and supports the following handlebars placeholders: `{{prefix}}`, `{{major}}`, `{{minor}}`, `{{patch}}`, `{{prerelease}}`, `{{build}}`, `{{version}}`.	no	{{prefix}}{{major}},{{prefix}}{{major}}.{{minor}}
ref	The SHA or ref to tag. Defaults to SHA of current commit.	no	${{ github.sha }}
when_exists	What to do if the tag already exists. Must be one of 'update', 'skip', or 'fail'.	no	update
annotation	Optional default annotation message for tags. If provided, creates annotated tags. If empty, creates lightweight tags. Can be overridden per-tag using the 'tag:ref:annotation' syntax in the tags input.	no	""
dry_run	If true, logs planned operations without executing them.	no	false
github_token	The GitHub token to use for authentication.	no	${{ github.token }}

name	description
tags	List of tags that were created/updated.
created	List of tags that were created.
updated	List of tags that were updated.
skipped	List of tags that were skipped.