Labels & Milestones

Labels and milestones help you organize and plan work. Labels are colored tags you attach to issues and merge requests; milestones group issues and merge requests under a shared target, usually a release or a date.

Labels

Labels are scoped to a single repository. Manage them from the repository's Issues → Labels page at /namespace/repo/-/labels. New repositories start with a set of default labels (bug, documentation, enhancement, good first issue, help wanted, and others).

Creating a Label

1. Open the repository and go to Labels
2. Click New label
3. Fill in the fields:
   • Name — required, 1–50 characters, unique within the repository
   • Color — required, a hex color like #ff0000. Use the color picker, or click the refresh icon to assign a random color
   • Description — optional, up to 500 characters
4. A live preview shows how the label badge will look. Click Save

Editing and Deleting

Each label row has Edit and Delete buttons. Editing lets you change the name, color, or description in place. Deleting a label removes it from every issue and merge request it was applied to.

Applying Labels

A label can be applied to any number of issues and merge requests, and an issue or merge request can carry many labels. You assign labels from the issue or merge request itself; the labels you create here are what's available to choose from.

Milestones

A milestone groups related issues and merge requests so you can track progress toward a goal such as a version or a deadline. Each milestone has:

• Title — required
• Description — optional
• State — active or closed (defaults to active). Close a milestone once its work is complete
• Due date — optional target date

Managing Milestones

Milestones are managed through the GitLab-compatible REST API rather than a dedicated UI page. Use the project milestones endpoints:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://#git.vianet.us/api/v4/projects/:id/milestones

Assigning Milestones

An issue or merge request can be assigned to a single milestone. When a merge request has a milestone, its title is shown in the merge request's sidebar. Group issues and merge requests under the same milestone to plan and review a body of work together.