gh-release-edit(1)

GH-RELEASE-EDIT(1) GitHub CLI manual GH-RELEASE-EDIT(1)

NAME

gh-release-edit - Edit a release

SYNOPSIS

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 CODES

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.

EXAMPLE

# 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

SEE ALSO

gh-release(1)

Jul 2026 GitHub CLI v2.96.0