GH-DISCUSSION-LIST(1) GitHub CLI manual GH-DISCUSSION-LIST(1)

# [NAME](#NAME)

gh-discussion-list - List discussions in a repository (preview)

# [SYNOPSIS](#SYNOPSIS)

**gh discussion list \[flags]**

# [DESCRIPTION](#DESCRIPTION)

List discussions in a GitHub repository. By default, only open discussions are shown.

# [OPTIONS](#OPTIONS)

[**--after** **<string>**](#after)

Cursor for the next page of results

[**--answered**](#answered)

Filter by answered state

[**-A**, **--author** **<string>**](#A)

Filter by author

[**-c**, **--category** **<string>**](#c)

Filter by category name or slug

[**-q**, **--jq** **<expression>**](#q)

Filter JSON output using a jq expression

[**--json** **<fields>**](#json)

Output JSON with the specified fields

[**-l**, **--label** **<strings>**](#l)

Filter by label

[**-L**, **--limit** **<int> (default 30)**](#L)

Maximum number of discussions to fetch

[**--order** **<string> (default "desc")**](#order)

Order of results: {asc|desc}

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

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

[**-S**, **--search** **<query>**](#S)

Search discussions with query

[**--sort** **<string> (default "updated")**](#sort)

Sort by field: {created|updated}

[**-s**, **--state** **<string> (default "open")**](#s)

Filter by state: {open|closed|all}

[**-t**, **--template** **<string>**](#t)

Format JSON output using a Go template; see "gh help formatting"

[**-w**, **--web**](#w)

List discussions in the web browser

# [ALIASES](#ALIASES)

gh discussion ls

# [JSON FIELDS](#JSON_FIELDS)

**answerChosenAt**, **answerChosenBy**, **answered**, **author**, **body**, **category**, **closed**, **closedAt**, **createdAt**, **id**, **labels**, **locked**, **number**, **stateReason**, **title**, **updatedAt**, **url**

# [EXIT CODES](#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](#EXAMPLE)

```
# List open discussions
$ gh discussion list
# List discussions with a specific category
$ gh discussion list --category General
# List closed discussions by author
$ gh discussion list --state closed --author monalisa
# List all discussions (closed or open) by label
$ gh discussion list --state all --label bug,enhancement
# List answered Q&A discussions as JSON
$ gh discussion list --answered --json number,title,url
# List unanswered Q&A discussions as JSON
$ gh discussion list --answered=false --json number,title,url
```

# [SEE ALSO](#SEE_ALSO)

[**gh-discussion(1)**](/man/os/gh/gh-discussion.1)

Sep 2026

---

Document: gh-discussion-list(1) from gh 2.102.0-r0 (Chainguard OS)
Source: https://github.com/cli/cli