GH-ISSUE-ARTIFACT-EDIT(1)

💅 GH-ISSUE-ARTIFACT-EDIT(1) — the GitHub CLI manual, bestie edition 🎀

okay so real talk: this is the manual page for gh-issue-artifact-edit from the GitHub CLI manual. yes it's a preview thing. yes it's iconic. let's go 💖

---

✨ NAME ✨

gh-issue-artifact-edit — edit an issue artifact (preview) 🦋

---

🌸 SYNOPSIS 🌸

gh issue artifact edit {<issue> <artifact-number> | <artifact-url>}
[flags]

---

💜 DESCRIPTION 💜

So what does it do? Two jobs, both slay: rename an issue artifact, or replace its content. That's it, that's the whole vibe. 🫶

But here's the thing — the type never changes. Not ever. So if you're editing a link, the new content has to be an http(s) URL or a .url Internet Shortcut file. No cap, that's the rule. 😭

You name the artifact one of two ways:

• by its issue and number, or
• by its URL.

And <issue> itself? That can be an issue number or an issue URL. Flexible queen behavior tbh 👑

More deets:

• If you use only --attach, the attachments get appended to the current content (not replacing it, bestie — appending 💅).
• With --restore-version, an earlier version's name and content are saved as a new version. And if you wanna see the edit history, that's what gh issue artifact view is for. ⭐

---

🔥 OPTIONS 🔥

• --attach <file> — attach an image or video file, in '#' format. drop that media, king 🎀
• -b, --body <string> — new content; and for a link, a URL. so like, the actual new stuff ✨
• -F, --body-file <file> — read new content from a file. and yes, use "-" to read from standard input, iykyk 🦋
• --name <string> — new name. rebrand yourself 💫
• --restore-version <number> (default 0) — restore the version with this number from the edit history. time travel but make it version control ⏪

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format. yes you can hop repos, main character energy 🌈

---

🚦 EXIT CODES 🚦

• 0 — successful execution, we ate and left no crumbs 🔥
• 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. fr fr, go check 👀

---

🌟 EXAMPLE 🌟

# Rename an artifact
$ gh issue artifact edit 142 2 --name 'OAuth callback plan v2'

# Replace a document's content with a file
$ gh issue artifact edit 142 2 --body-file 2-OAuth-callback-plan.md

# Point a link at a new URL
$ gh issue artifact edit 142 3 --body https://github.com/monalisa/monas-cafe/wiki/OAuth-runbook-v2

# Append an image to a document
$ gh issue artifact edit 142 2 --attach ./signin-flow.png

# Restore an earlier version
$ gh issue artifact edit 142 2 --restore-version 5

literally just copy these, they work 💅

---

🦋 SEE ALSO 🦋

• gh-issue-artifact(1) — the parent command, go say hi 🫶

---

okay that's the whole page!! mwah 💖 this was GitHub CLI 2.103.3, dated Oct 2026 — catch you on the next man page, bestie! 🎀✨