actions-marketplace-validations/Create Release

Creates github releases

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Mar 29, 2026
License: MIT

Pinned Snippet

workflow.ymlSHA-pinned

uses: actions-marketplace-validations/ncipollo_release-action@e8998be2b17923c3291d578fe182ba04c16fc023 # no releases — HEAD as of 2026-07-13

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

Inputs

name	description	required	default
allowUpdates	An optional flag which indicates if we should update a release if it already exists. Defaults to false.	no	""
artifactErrorsFailBuild	An optional flag which indicates if artifact read or upload errors should fail the build.	no	""
artifact	An optional set of paths representing artifacts to upload to the release. This may be a single path or a comma delimited list of paths (or globs)	no	""
artifacts	An optional set of paths representing artifacts to upload to the release. This may be a single path or a comma delimited list of paths (or globs)	no	""
artifactContentType	The content type of the artifact. Defaults to raw	no	""
body	An optional body for the release.	no	""
bodyFile	An optional body file for the release. This should be the path to the file	no	""
commit	An optional commit reference. This will be used to create the tag if it does not exist.	no	""
discussionCategory	When provided this will generate a discussion of the specified category. The category must exist otherwise this will cause the action to fail. This isn't used with draft releases	no	""
draft	Optionally marks this release as a draft release. Set to true to enable.	no	""
generateReleaseNotes	Indicates if release notes should be automatically generated.	no	false
generateReleaseNotesPreviousTag	An optional previous tag to use when generating release notes. This will limit the release notes to changes between the two tags.	no	""
immutableCreate	Indicates if immutable release creation should be used. When enabled, the action will first create a draft, upload artifacts, then publish the release.	no	false
makeLatest	Indicates if the release should be the "latest" release or not.	no	legacy
name	An optional name for the release. If this is omitted the tag will be used.	no	""
omitBody	Indicates if the release body should be omitted.	no	false
omitBodyDuringUpdate	Indicates if the release body should be omitted during updates. The body will still be applied for newly created releases. This will preserve the existing body during updates.	no	false
omitDraftDuringUpdate	Indicates if the draft flag should be omitted during updates. The draft flag will still be applied for newly created releases. This will preserve the existing draft state during updates.	no	false
omitName	Indicates if the release name should be omitted.	no	false
omitNameDuringUpdate	Indicates if the release name should be omitted during updates. The name will still be applied for newly created releases. This will preserve the existing name during updates.	no	false
omitPrereleaseDuringUpdate	Indicates if the prerelease flag should be omitted during updates. The prerelease flag will still be applied for newly created releases. This will preserve the existing prerelease state during updates.	no	false
owner	Optionally specify the owner of the repo where the release should be generated. Defaults to current repo's owner.	no	""
prerelease	Optionally marks this release as prerelease. Set to true to enable.	no	""
removeArtifacts	Indicates if existing release artifacts should be removed, Defaults to false.	no	false
replacesArtifacts	Indicates if existing release artifacts should be replaced. Defaults to true.	no	true
repo	Optionally specify the repo where the release should be generated. Defaults to current repo	no	""
skipIfReleaseExists	When skipIfReleaseExists is enabled the action will be skipped if a non-draft release already exists for the provided tag.	no	false
tag	An optional tag for the release. If this is omitted the git ref will be used (if it is a tag).	no	""
token	The Github token.	no	${{ github.token }}
updateOnlyUnreleased	When allowUpdates is enabled, this will fail the action if the release it is updating is not a draft or a prerelease.	no	false

Outputs

name	description
id	The identifier of the created release.
html_url	The HTML URL of the release.
upload_url	The URL for uploading assets to the release.
tarball_url	The URL for downloading the release as a tarball (.tar.gz).
zipball_url	The URL for downloading the release as a zipball (.zip).
assets	JSON string containing a map of asset names to download URLs for uploaded assets.