Your company here ā€” click to reach over 10,000 unique daily visitors

gh-issue-create - Man Page

Create a new issue

Examples (TL;DR)


gh issue create [flags]


Create an issue on GitHub.

Adding an issue to projects requires authorization with the project scope. To authorize, run gh auth refresh -s project.


-a, --assignee <login>

Assign people by their login. Use "@me" to self-assign.

-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)

-l, --label <name>

Add labels by name

-m, --milestone <name>

Add the issue to a milestone by name

-p, --project <name>

Add the issue to projects by name

--recover <string>

Recover input from a failed run of create

-T, --template <name>

Template name to use as starting body text

-t, --title <string>

Supply a title. Will prompt for one otherwise.

-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


$ gh issue create --title "I found a bug" --body "Nothing works"
$ 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 --project "Roadmap"

See Also


Referenced By


Mar 2024 GitHub CLI manual