summaryrefslogtreecommitdiff
path: root/doc/user/project/labels.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user/project/labels.md')
-rw-r--r--doc/user/project/labels.md28
1 files changed, 16 insertions, 12 deletions
diff --git a/doc/user/project/labels.md b/doc/user/project/labels.md
index 22dfd3a8719..c0a66343a88 100644
--- a/doc/user/project/labels.md
+++ b/doc/user/project/labels.md
@@ -59,21 +59,25 @@ and edit labels.
> Showing all inherited labels [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/241990) in GitLab 13.5.
-To view the project labels list, navigate to the project and click **Issues > Labels**.
-The list includes all labels that are defined at the project level, as well as all
-labels defined by its ancestor groups.
-For each label, you can see the project or group path from where it was created.
-You can filter the list by entering a search query at the top and clicking search (**{search}**).
+To view a project's available labels, in the project, go to **Issues > Labels**.
+Its list of labels includes both the labels defined at the project level, and
+all labels defined by its ancestor groups. For each label, you can see the
+project or group path from where it was created. You can filter the list by
+entering a search query in the **Filter** field, and then clicking its search
+icon (**{search}**).
To create a new project label:
-1. Navigate to **Issues > Labels** in the project.
-1. Click the **New label** button.
- - Enter the title.
- - (Optional) Enter a description.
- - (Optional) Select a background color by clicking on the available colors, or input
- a hex color value for a specific color.
-1. Click **Create label** to create the label.
+1. In your project, go to **Issues > Labels**.
+1. Select the **New label** button.
+1. In the **Title** field, enter a short, descriptive name for the label. You
+ can also use this field to create [scoped, mutually exclusive labels](#scoped-labels).
+1. (Optional) In the **Description** field, you can enter additional
+ information about how and when to use this label.
+1. (Optional) Select a background color for the label by selecting one of the
+ available colors, or by entering a hex color value in the **Background color**
+ field.
+1. Select **Create label**.
You can also create a new project label from within an issue or merge request. In the
label section of the right sidebar of an issue or a merge request: