gh-label-edit(1)

gh-label-edit1

Edit a label

Usage

gh label edit <name> [flags]

Overview

Update a label on GitHub.

A label can be renamed using the --name flag.

The label color needs to be 6 character hex value.

Options

-c, --color <string>

Color of the label

-d, --description <string>

Description of the label

-n, --name <string>

New name of the label

Options inherited from parent commands

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

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

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

# Update the color of the bug label
$ gh label edit bug --color FF0000
# Rename and edit the description of the bug label
$ gh label edit bug --name big-bug --description "Bigger than normal bug"

Releases

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

  1. 12
  2. 13
  3. Arch

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