Milestones

Milestones group a repository's issues toward a shared goal, such as a release or a deadline, and track how close that goal is. The milestones page lists every milestone in a repository with its status, due date, open and closed issue counts, and a progress bar, and it lets people with write access create, edit, and delete milestones.

Where to find it

Milestones belong to a repository and live under its issues.

• URL: gitvetrix.com/<owner>/<repo>/issues/milestones
• From an issue: open any issue in a repository that has no milestones yet. The Milestone section of the issue sidebar shows a Create one link that opens this page.
• From the milestones page, select ← Back to Issues to return to the repository's issue list.

Creating, editing, and deleting milestones requires write access to the repository. Without it, you still see the milestone list, but the New milestone, Edit, and Delete controls do not appear.

Read the milestone list

1. Open the milestones page. The heading Milestones sits at the top.
2. Read each milestone card. Every card shows:
   • the milestone title, which links to its issues;
   • a status badge reading open or closed;
   • the due date, shown as Due followed by the date when one is set. An open milestone whose date has passed shows ⚠ Overdue · before the date, in red;
   • a count line reading <open> open · <closed> closed;
   • a progress bar with the plain-text equivalent <closed> of <total> issues closed, <percent>% beside it.
3. If the repository has no milestones, the page shows No milestones with the note "Create milestones to group issues and track progress toward a goal."

The progress bar fills as the issues in a milestone are closed. A milestone with no issues reads 0 of 0 issues closed, 0%.

Create a milestone

1. Select New milestone in the top-right corner. A New milestone form opens above the list.
2. In Title, type a name for the milestone. A title is required.
3. Optionally, add a short Description.
4. Optionally, set a Due date using the date picker. This is an optional target date.
5. Select Create milestone to save it, or Cancel to discard the form.

The new milestone appears in the list and a Milestone created confirmation is shown.

Edit a milestone

1. Find the milestone in the list and select Edit. The card turns into a form pre-filled with the milestone's current values.
2. Change the Title, Description, or Due date as needed. Clearing the Due date field removes the target date.
3. Select Update milestone to save your changes, or Cancel to leave the milestone unchanged.

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

Delete a milestone

1. Find the milestone in the list and select Delete.
2. In the Delete milestone dialog, read the warning: "Issues in this milestone will not be deleted; their milestone will be cleared."
3. Select Delete milestone to confirm, or close the dialog to keep the milestone.

Deleting a milestone does not delete its issues. Each issue that belonged to the milestone simply loses it.

See a milestone's issues

Select a milestone's title to open the repository's issue list filtered to that milestone, so you see only the issues assigned to it.

Related pages

• Issues — the repository issue list, where you can filter issues by milestone.
• Issue detail — assign a single issue to a milestone from its sidebar.