gh-label-list(1)

gh-label-list1

List labels in a repository

Usage

gh label list [flags]

Overview

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.

Options

-q, --jq <expression>

Filter JSON output using a jq expression

--json <fields>

Output JSON with the specified fields

-L, --limit <int> (default 30)

Maximum number of labels to fetch

--order <string> (default "asc")

Order of labels returned: {asc|desc}

-S, --search <string>

Search label names and descriptions

--sort <string> (default "created")

Sort fetched labels: {created|name}

-t, --template <string>

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

-w, --web

List labels in the web browser

Options inherited from parent commands

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

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

Aliases

gh label ls

Json fields

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

Exit status

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.

Examples

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

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

--limit until Debian 12 (Bookworm); --order until Debian 12 (Bookworm); --sort until Debian 12 (Bookworm); -L until Debian 12 (Bookworm).

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.