GH-ISSUE-CREATE(1)

NAME
gh-issue-create - Create a new issue

SYNOPSIS
gh issue create [flags]

DESCRIPTION
Create an issue on GitHub.

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

The --assignee flag supports the following special values: - @me: assign yourself - @copilot: assign Copilot (not supported on GitHub Enterprise Server)

OPTIONS

-a, --assignee <login>
    Assign people by their login. Use "@me" to self-assign.

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

-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

-p, --project <title>
    Add the issue to projects by title

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

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

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.

EXAMPLE
    $ 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 --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

SEE ALSO
gh-issue(1)