GH-ISSUE-CREATE(1)

💅 GH-ISSUE-CREATE(1) — like, the GitHub CLI manual, but make it make sense ✨

okay bestie, so this is the gh issue create page from the GitHub CLI manual (v2.102.0, October 2026 energy), and it's genuinely one of the most useful commands ever. It literally creates issues for you. Let's get into it 🫶

---

🌸 NAME 🌸

gh-issue-create — create a new issue. That's it, that's the vibe. A whole new issue, born from your terminal, no browser tab chaos required ✨

---

🦋 SYNOPSIS 🦋

gh issue create [flags]

---

💖 DESCRIPTION 💖

Create an issue on GitHub. Iconic behaviour, no notes 💅

Use --attach to upload an image or video. The attachment is appended to the body. And here's the cute part: if the body already references an attached file, like ![alt](./login.png), that reference gets rewritten to point at the uploaded asset instead. So no broken images, we love to see it. You can attach up to 50 files per command — fifty! main character energy fr fr.

Alt text for an image follows the path after #, as in --attach './login.png#The login error state'. Without it the filename is used. A reference already in the body keeps the alt text written there. Video renders as a player and has no alt text, so it cannot be given any — sorry video girlies, that's just how it is 🙈

If some attachments upload and others fail, the issue is still created with the ones that succeeded. The command then exits with a non-zero status, but the new issue's URL is still printed to stdout. So like, partial slay but you still get your link 💖

Adding an issue to projects requires authorization with the project scope. To authorize, run gh auth refresh -s project. Don't skip this or you'll be sad.

The --assignee flag supports the following special values:

• @me: assign yourself (self-assignment, the ultimate main character move 👑)
• @copilot: assign Copilot (not supported on GitHub Enterprise Server — noted, no cap)

---

✨ OPTIONS ✨

• -a, --assignee <login> — assign people by their login. Use "@me" to self-assign 💜
• --attach <file> — attach an image or video file, in '#' format (that's the path#alt text situation we talked about 🎀)
• --blocked-by <numbers> — mark the new issue as blocked by these issue numbers or URLs
• --blocking <numbers> — mark the new issue as blocking these issue numbers or URLs
• -b, --body <string> — supply a body. Will prompt for one otherwise.
• -F, --body-file <file> — read body text from file (use "-" to read from standard input)
• -e, --editor — skip prompts and open the text editor to write the title and body in. The first line is the title and the remaining text is the body. Fancy ✍️
• -l, --label <name> — add labels by name
• -m, --milestone <name> — add the issue to a milestone by name
• --parent <number> — add the new issue as a sub-issue of the specified parent number or URL (baby issue 🍼)
• -p, --project <title> — add the issue to projects by title
• --recover <string> — recover input from a failed run of create. Yes bestie, it happens to the best of us 😭
• -T, --template <name> — template name to use as starting body text
• -t, --title <string> — supply a title. Will prompt for one otherwise.
• --type <name> — set the issue type by name
• -w, --web — open the browser to create an issue

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

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

---

🎀 ALIASES 🎀

gh issue new

Same energy, shorter typing. iykyk 💅

---

⭐ EXIT CODES ⭐

• 0: Successful execution — ate and left no crumbs 🔥
• 1: Error — it's giving chaos
• 2: Command canceled — you changed your mind, valid
• 4: Authentication required — go log in bestie 🙈

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

---

🍓 EXAMPLE 🍓

$ gh issue create --title "I found a bug" --body "Nothing works"
$ gh issue create --attach './login.png#The login error state'
$ gh issue create --attach ./before.png --attach ./after.png
$ gh issue create --label "bug,help wanted"
$ gh issue create --label bug --label "help wanted"
$ gh issue create --assignee monalisa,hubot
$ gh issue create --assignee "@me"
$ gh issue create --assignee "@copilot"
$ gh issue create --project "Roadmap"
$ gh issue create --template "Bug Report"
$ gh issue create --type Bug
$ gh issue create --parent 100
$ gh issue create --parent https://github.com/cli/go-gh/issues/42
$ gh issue create --blocked-by 200,201 --blocking 300

Look at all those combos. Label comma-separated or repeated flags, both work, we love options 👑

---

🧚 SEE ALSO 🧚

gh-issue(1) — go read the parent page, it's the whole issue family 💜

---

that's the whole page bestie, no cap, every flag and caveat intact 💖 This masterpiece is from the GitHub CLI v2.102.0 manual, dated Oct 2026 — go create some issues, you're gonna slay 🎀✨🦋