gh issue create Open a new issue

Creates an issue in a repository to report a bug or track a task. Without flags it asks for a title and description.

Synopsis

gh issue create [FLAGS]

Common options

Option or formWhat it does
-t, --title TEXTIssue title
-b, --body TEXTIssue description
-l, --label NAMEAdd a label (repeat for several)
-a, --assignee USERAssign someone (@me for yourself)
-m, --milestone NAMEAdd to a milestone
-w, --webOpen the browser to write it

Examples

Create one interactively
gh issue create
Create it in one line
gh issue create --title "Search fails on empty query" --body "Steps: open search, press enter."
Label it and assign it to yourself
gh issue create -t "Add dark mode" -l enhancement -a "@me"
Use a file for a long description
gh issue create -t "Crash on save" --body-file report.md

Notes

See also

Last reviewed 2026-10-09.