gh release create

Create a new release

Synopsis

Create a new GitHub Release for a repository.

A list of asset files may be given to upload to the new release. To define a display label for an asset, append text starting with ‘#’ after the file name.

gh release create <tag> [<files>...] [flags]

Examples

# use release notes from a file
$ gh release create v1.2.3 -F changelog.md

# upload a release asset with a display label
$ gh release create v1.2.3 '/path/to/asset.zip#My display label'

Options

  -d, --draft             Save the release as a draft instead of publishing it
  -n, --notes string      Release notes
  -F, --notes-file file   Read release notes from file
  -p, --prerelease        Mark the release as a prerelease
      --target branch     Target branch or commit SHA (default: main branch)
  -t, --title string      Release title

Options inherited from parent commands

      --help              Show help for command
  -R, --repo OWNER/REPO   Select another repository using the OWNER/REPO format