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

gh-label-list - List labels in a repository

gh label list [flags]

Display labels in a GitHub repository.

When using the --search flag results are sorted by best match of the query. This behavior cannot be configured with the --order or --sort flags.

Filter JSON output using a jq expression
Output JSON with the specified fields
Maximum number of labels to fetch
Order of labels returned: {asc|desc}
Search label names and descriptions
Sort fetched labels: {created|name}
Format JSON output using a Go template; see "gh help formatting"
List labels in the web browser

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

gh label ls

color, createdAt, description, id, isDefault, name, updatedAt, url

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.

# Sort labels by name
$ gh label list --sort name
# Find labels with "bug" in the name or description
$ gh label list --search bug

gh-label(1)

Jun 2025