liquidlogiclabs/Git Create/Update Tag
Create or update Git tags on local or remote repositories. Supports GitHub, Gitea, Bitbucket, and generic Git hosts with optional GPG signing.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| tag-name | Name of the tag to create/update | yes | — |
| tag-message | Message for annotated tags. If provided, creates an annotated tag; if omitted, creates a lightweight tag | no | — |
| tag-sha | Commit SHA to tag (defaults to current HEAD) | no | — |
| repository | Repository URL or owner/repo format (defaults to current repo) | no | — |
| token | Authentication token (defaults to GITHUB_TOKEN) | no | — |
| update-existing | Whether to update existing tags (default: false) | no | false |
| gpg-sign | Whether to GPG sign the tag (default: false) | no | false |
| gpg-key-id | GPG key ID to use for signing | no | — |
| repo-type | Repository type ('github', 'gitea', 'bitbucket', 'generic', 'git', 'auto'). Default: 'auto' (auto-detect from repository URL). 'git' and 'generic' are equivalent aliases for local Git CLI operations. | no | auto |
| base-url | Base URL for self-hosted instances | no | — |
| skip-certificate-check | Skip TLS certificate verification (default: false) | no | false |
| force | Force update even if tag exists (default: false) | no | false |
| verbose | Enable verbose/debug logging (default: false). Also enabled when ACTIONS_STEP_DEBUG, ACTIONS_RUNNER_DEBUG, or RUNNER_DEBUG is true. | no | false |
| push-tag | Push the tag to the remote repository after creating/updating (default: true). Only applies when using local Git CLI. | no | true |
| git-user-name | Git user name for annotated tags. Auto-detected from GITHUB_ACTOR/GITEA_ACTOR if not provided. Falls back to local git config. | no | — |
| git-user-email | Git user email for annotated tags. Auto-detected from GITHUB_ACTOR/GITEA_ACTOR if not provided. Falls back to local git config. | no | — |
Outputs
| name | description |
|---|---|
| tag-name | Name of the tag that was created/updated |
| tag-sha | SHA of the commit that was tagged |
| tag-exists | Whether the tag already existed (true/false) |
| tag-updated | Whether an existing tag was updated (true/false) |
| tag-created | Whether a new tag was created (true/false) |
| platform | Detected or specified platform (same as repo_type input or detected value) |