GH-ISSUE-ARTIFACT-CREATE(1)

🎀 GH-ISSUE-ARTIFACT-CREATE(1) 🎀

okay so this is from the GitHub CLI manual bestie, and it's literally about making issue artifacts. preview mode, very exclusive 💅

---

✨ NAME ✨

gh-issue-artifact-create — create issue artifacts (preview)

---

🦋 SYNOPSIS 🦋

gh issue artifact create {<issue-number> | <issue-url>} [<file>[#<name>]
| <url>]... [flags]

---

💖 DESCRIPTION 💖

So every file or URL you hand over gets its own artifact, one each — no cap. Here's the vibe check on what becomes what:

• A text file becomes a document named after the file. Want a different name? Just add #<name> to it. slay.
• A .html or .htm file becomes an HTML document.
• A URL — or a .url Internet Shortcut file — becomes a link, and a URL is named after its host. iconic behavior honestly.

Now, artifact names can't contain some characters, parentheses being a big one. When a file's name has them, they get removed, so plan (1).md ends up named plan 1.md. it's giving tidy ✨

Use --body if you want to create a single document from text, or --body-file to create one artifact from a file — and - reads standard input, obviously 🫶. Then --name sets its name.

Documents get saved as generic, and HTML documents as embedded_html. If you want to force it, use --type to set the type of every document instead, whatever the file extension says. And a plan currently behaves the same as a generic document — that's just how it is rn 🙈

---

💅 OPTIONS 💅

• --attach <file> — attach an image or video file, in '#' format
• -b, --body <string> — content for a single document
• -F, --body-file <file> — read content for a single artifact from file (use - to read from standard input)
• --name <string> — name for a single artifact
• --type <string> — type for documents: {generic|plan|embedded_html}

---

🌸 OPTIONS INHERITED FROM PARENT COMMANDS 🌸

• -R, --repo <[HOST/]OWNER/REPO> — select another repository using the [HOST/]OWNER/REPO format

---

🌈 ALIASES 🌈

gh issue artifact new — same energy, shorter walk 🚶‍♀️

---

⭐ 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. iykyk

---

🍓 EXAMPLE 🍓

Create a document from a file:

$ gh issue artifact create 142 signin-plan.md

Create documents from two files, naming the first:

$ gh issue artifact create 142 'docs/signin-plan.md#Sign-in plan' oauth-research.md

Create an HTML document from a file:

$ gh issue artifact create 142 menu-prototype.html

Create a link with a name:

$ gh issue artifact create 142 https://github.com/monalisa/monas-cafe/wiki/OAuth-runbook --name 'Staging OAuth runbook'

Create a document from standard input:

$ cat order-sync.log | gh issue artifact create 142 --body-file - --name 'Order sync log'

Upload an image that the document references:

$ gh issue artifact create 142 signin-plan.md --attach ./signin-flow.png

---

🧚 SEE ALSO 🧚

gh-issue-artifact(1) — go read that one next bestie 💜

---

that's the whole page!! mwah 💋 this one's from GitHub CLI 2.103.3, dated Oct 2026 — drink some water, go create an artifact, and ily 🫶✨