Labels and issue types

A repository's labels and issue types shape how its issues and merge requests are organized. Labels are the coloured tags you apply to issues and merges to categorize and filter them. The issue type scheme decides which issue types, such as Bug or Story, are available in the repository and the order they appear in. Both are repository settings, each on its own page.

Where to find it

Both pages live under a repository's settings.

Labels URL: gitvetrix.com/<owner>/<repo>/settings/labels
Issue types URL: gitvetrix.com/<owner>/<repo>/settings/issue-types
From the repository: open the repository's Settings, then choose Labels or Issue Types in the settings sidebar.

Managing labels or the issue type scheme requires owner or administrator access to the repository. Without it, the page shows a message noting you do not have permission to manage that setting.

Manage labels

The Labels page lists the repository's labels and lets you create, edit, and delete them. Labels help you categorize and filter issues and merges.

Read the label list

Open the labels page. The heading Labels sits at the top, with a New label button beside it.
Read each row. A label row shows a colour swatch, the label rendered as a coloured pill using its name and colour, its description when it has one, and Edit and Delete controls.
If the repository has no labels, the page shows No labels with the note "Labels help you categorise and filter issues and merges."

Create a label

Select New label. A New label form opens above the list.
In Name, type the label text, such as bug or enhancement. A name is required.
Choose a Colour. Select one of the preset swatches, or type a six-character hex value in the field beside the # prefix. A live preview pill shows the label as it will appear.
Read the contrast status shown below the colour field. It reads passes AA or fails AA with a matching glyph, telling you whether the colour has enough contrast against white text to be legible.
Select Create label to save it, or Cancel to discard the form.

The new label appears in the list and a Label created confirmation is shown.

Edit a label

Find the label in the list and select Edit. The row turns into a form pre-filled with the label's current name and colour.
Change the Name or Colour as needed. The preview and contrast status update as you go.
Select Update label to save your changes, or Cancel to leave the label unchanged.

A Label updated confirmation is shown once the change is saved.

Delete a label

Find the label in the list and select Delete.
In the Delete label dialog, read the warning: "This label will be removed from all issues and merges."
Select the confirm button, which names the label, to delete it, or close the dialog to keep it.

A Label deleted confirmation is shown. The label is removed from every issue and merge that carried it.

Manage the issue type scheme

The Issue Type Scheme page decides which issue types a repository offers and their order. Its heading reads Issue Type Scheme, and it is laid out in two columns.

Read the scheme

The Available types column on the left lists the global issue types that are not yet in the repository's scheme. Each entry shows the type as a coloured badge, marks sub-task types with (sub-task), and offers an Enable button. When every global type is already active, the column notes that all global issue types are already in this repository's scheme, with the current count included in the message (for example, "All 6 global issue types are already in this repository's scheme.").
The Active scheme column on the right is a table of the types currently in the scheme. Each row shows its position number, the type badge, up and down controls, and a Disable button. When no types are active, the column reads "No types in scheme. Enable at least one type from the available list."

Enable a type

Find the type in the Available types column and select Enable. The type moves to the end of the Active scheme table, and an Issue type scheme updated confirmation is shown.

Reorder active types

In the Active scheme table, use the up and down controls on a row to move that type earlier or later in the scheme. The up control is unavailable on the first row and the down control on the last. Each move saves immediately and shows an Issue type scheme updated confirmation.

Disable a type

Find the type in the Active scheme table and select Disable to remove it from the scheme. A scheme must keep at least one type, so the last remaining type cannot be disabled: while a type is the only one in the scheme, its Disable button is disabled and cannot be selected.

Issues list — browse and filter a repository's issues by label and issue type.
Issue detail — apply labels and set an issue's type from its details panel.
Merge requests — where labels also help organize proposals.
Project configuration — define the instance-wide issue types, workflows, and link types that repositories draw on.