gh-release-edit(1)

gh-release-edit1

Edit a release

Usage

gh release edit <tag>

Options

--discussion-category <string>

Start a discussion in the specified category when publishing a draft

--draft

Save the release as a draft instead of publishing it

--latest

Explicitly mark the release as "Latest"

-n, --notes <string>

Release notes

-F, --notes-file <file>

Read release notes from file (use "-" to read from standard input)

--prerelease

Mark the release as a prerelease

--tag <string>

The name of the tag

--target <branch>

Target branch or full commit SHA (default [main branch])

-t, --title <string>

Release title

--verify-tag

Abort in case the git tag doesn't already exist in the remote repository

Options inherited from parent commands

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

Exit status

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

Examples

# Publish a release that was previously a draft
$ gh release edit v1.0 --draft=false
# Update the release notes from the content of a file
$ gh release edit v1.0 --notes-file /path/to/release_notes.md

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

--verify-tag since Debian 13 (Trixie).

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.