gh-discussion-create - Man Page

Create a new discussion (preview)

Synopsis

gh discussion create [flags]

Description

Create a new GitHub Discussion in a repository.

With '--title', '--body', and '--category', a discussion is created non-interactively. Omitting any of these flags triggers interactive prompts when connected to a terminal.

Options

-b, --body <string>

Body for the discussion

-F, --body-file <string>

Read body text from file (use "-" to read from stdin)

-c, --category <string>

Category name or slug for the discussion

-l, --label <strings>

Labels to apply to the discussion

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

-t, --title <string>

Title for the discussion

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

# Create interactively
$ gh discussion create

# Create non-interactively
$ gh discussion create --title "My question" --category "Q&A" --body "Details here"

See Also

gh-discussion(1)

Referenced By

gh-discussion(1).

Jun 2026 GitHub CLI manual