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



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



SYNOPSIS
       gh discussion list [flags]



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



OPTIONS
       --after <string>
              Cursor for the next page of results


       --answered
              Filter by answered state


       -A, --author <string>
              Filter by author


       -c, --category <string>
              Filter by category name or slug


       -q, --jq <expression>
              Filter JSON output using a jq expression


       --json <fields>
              Output JSON with the specified fields


       -l, --label <strings>
              Filter by label


       -L, --limit <int> (default 30)
              Maximum number of discussions to fetch


       --order <string> (default "desc")
              Order of results: {asc|desc}


       -R, --repo <[HOST/]OWNER/REPO>
              Select another repository using the [HOST/]OWNER/REPO format


       -S, --search <query>
              Search discussions with query


       --sort <string> (default "updated")
              Sort by field: {created|updated}


       -s, --state <string> (default "open")
              Filter by state: {open|closed|all}


       -t, --template <string>
              Format JSON output using a Go template; see "gh help formatting"


       -w, --web
              List discussions in the web browser



ALIASES
       gh discussion ls



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



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
       # 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
       gh-discussion(1)

                                   Jun 2026              GH-DISCUSSION-LIST(1)