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

# [NAME](#NAME)

gh-label-create - Create a new label

# [SYNOPSIS](#SYNOPSIS)

**gh label create <name> \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Create a new label on GitHub, or update an existing one with **--force**.

Must specify name for the label. The description and color are optional. If a color isn't provided, a random one will be chosen.

The label color needs to be 6 character hex value.

# [OPTIONS](#OPTIONS)

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

Color of the label

[**-d**, **--description** **<string>**](#d)

Description of the label

[**-f**, **--force**](#f)

Update the label color and description if label already exists

# [OPTIONS INHERITED FROM PARENT COMMANDS](#OPTIONS_INHERITED_FROM_PARENT_COMMANDS)

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

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

# [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)

```
# Create new bug label
$ gh label create bug --description "Something isn't working" --color E99695
```

# [SEE ALSO](#SEE_ALSO)

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

Sep 2026

---

Document: gh-label-create(1) from gh 2.101.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli