GH-RELEASE-EDIT(1)

✨ NAME ✨

okay so bestie, this is gh-release-edit from the GitHub CLI manual — it's the glow-up command that edits a release 💅 (yes, you can fix your typos after publishing, we love a second chance moment)

---

🌸 SYNOPSIS 🌸

gh release edit <tag>

that's it, that's the whole vibe — you point it at a tag and it does the rest 🎀

---

💖 OPTIONS 💖

• --discussion-category <string> — when you're publishing a draft, this starts a discussion in the category you name 🗣️
• --draft — saves the release as a draft instead of publishing it, so it stays in the group chat drafts folder 🙈
• --latest — explicitly marks the release as "Latest", no cap, you're the main character now 👑
• -n, --notes <string> — the release notes, your little love letter ✍️
• -F, --notes-file <file> — reads the release notes from a file instead (and if you pass "-" it reads from standard input, iconic) 🍓
• --prerelease — marks the release as a prerelease, the "not ready for the world yet" era 🌱
• --tag <string> — the name of the tag 🏷️
• --target <branch> — target branch or a full commit SHA (default is [main branch]) 🎯
• -t, --title <string> — the release title, make it cute 💜
• --verify-tag — aborts if the git tag doesn't already exist in the remote repository, so it's the vibe-check-before-you-commit option 🔥

---

🦋 OPTIONS INHERITED FROM PARENT COMMANDS 🦋

• -R, --repo <[HOST/]OWNER/REPO> — selects a different repository using the [HOST/]OWNER/REPO format, for when you're being nosy about someone else's repo 👀

---

⭐ EXIT CODES ⭐

• 0: Successful execution — slay, it worked 💅
• 1: Error — it's giving chaos 😭
• 2: Command canceled — you backed out, no judgement 🫶
• 4: Authentication required — log in first bestie 🔑

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

look at that — one flag flips a draft into a full published release, and the other pulls your notes straight out of a file. ate and left no crumbs 🍓✨

---

🧚 SEE ALSO 🧚

• gh-release(1) — go read the big one, iykyk 💜

---

and that's the whole page bestie!! this was GitHub CLI v2.102.0, dated Oct 2026 — fr fr, go edit some releases now, you're gonna do amazing 🎀💖🦋