GitLab Labeling Training

1. You are here:
2. Handbook
3. Support Team Handbook
4. Support Operations Team
5. Support Operations Training
6. GitLab Labeling Training

On this page

• What this covers
• What are GitLab labels
  • Scoped labels
• How to create a GitLab label
• How to edit a GitLab label
• How to delete a GitLab label
• Important GitLab labels for Supprot Operations
• Useful links

What this covers

This training material will cover the following topics:

• What GitLab labels are
• How to create a GitLab label
• How to edit a GitLab label
• How to delete a GitLab label
• Important labels for support ops

What are GitLab labels

Labels help you tag issues, merge requests, and epics within GitLab.

There are two types of labels:

• Project labels: ones existing at the project level only
• Group labels: ones existing at the group level, and are thus inherited to all subgroups and projects within the group

Support Operations uses Group labels so we can apply them to every item we work on. We create them at either the gitlab-com group level or the support-ops group level.

Scoped labels

As per GitLab:

Scoped labels allow teams to use the label feature to annotate issues, merge requests and epics with mutually exclusive labels. This can enable more complicated workflows by preventing certain labels from being used together.

To use a scoped label, it must contain two colons (::) in the title. This makes it so the first part (before the double colons) is a category and the second part (after the double colons) is the label for the category.

Do note only scoped label from a scoped label category can be present at any time. Adding a new one will remove the other one from the scoped label category.

How to create a GitLab label

To create a label at the project level, go to the project in question within GitLab and hover on Project information on the left-hand side of the page. In the submenu that appears, click on Labels.

To create a label at the group level, go to the group in question within GitLab and hover on Group information (or Subgroup information if you are using a subgroup) on the left-hand side of the page. In the submenu that appears, click on Labels.

From here, click the blue New label button in the top-right of the page. On the page this takes you to, you will add a title for your label, a description for your label, and a background color for the label. After you have filled these out, click the blue Create label button to create the label. You will now be able to use that label at the project level (for Project labels) or on all projects/subgroups under the group (for Group labels).

How to edit a GitLab label

To edit a label at the project level, go to the project in question within GitLab and hover on Project information on the left-hand side of the page. In the submenu that appears, click on Labels.

To edit a label at the group level, go to the group in question within GitLab and hover on Group information (or Subgroup information if you are using a subgroup) on the left-hand side of the page. In the submenu that appears, click on Labels.

From here, locate the label you wish to edit and click the pencil icon on the right-hand side of the label box to edit it. Here you can change the title, description, or background color. Keep in mind that changing this will change it on all items the label is present on.

After you are done making your changes, click the blue Save changes button.

How to delete a GitLab label

To delete a label at the project level, go to the project in question within GitLab and hover on Project information on the left-hand side of the page. In the submenu that appears, click on Labels.

To delete a label at the group level, go to the group in question within GitLab and hover on Group information (or Subgroup information if you are using a subgroup) on the left-hand side of the page. In the submenu that appears, click on Labels.

From here, locate the label you wish to delete and click the three vertical dots on the right-hand side of the label box. On the submenu that appears, click the Delete option. This will make a pop-up box appear asking you to confirm the deletion. Keep in mind that doing so will remove the label from all items it exists on. If you are sure you wish to confirm the deletion, click the red Delete label button.

Important GitLab labels for Supprot Operations

Useful links

• GitLab Labels documentation