Managing and Configuring Tags

You can create and manage tags for your project from the Project Settings: Tags page. You can use the tags in issues and merge requests.

Creating a Tag

A tag is a keyword that can be used to categorize an artifact, such as an issue or a merge request. You can add multiple tags in your project. By default, three tags (Plan, Release, and Epic) are available when a project is created.

To create a tag:
  1. In the navigation bar, click Project Settings.
  2. Click the Tags tab.
  3. Click New Tag.
  4. In Tag Name, enter a unique name and press Enter.
    The tag name must contain only letters and numbers.

Renaming a Tag

On the Tags page, select the tag and rename it.

To rename a tag:
  1. In the navigation bar, click Project Settings.
  2. Click Tags.
  3. Select the tag.
  4. Enter a new name and move the cursor out of the text box to save it.

Removing a Tag

You can delete a tag from the Tags page.

You cannot delete a tag if artifacts refer to it. First remove all artifacts that refer to the tag, and then remove the tag.

To remove a tag:
  1. In the navigation bar, click Project Settings.
  2. Click Tags.
  3. In the tag name, to the right side of the name, click DeleteDelete.
After confirmation, the tag is removed.