> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weaveos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Milestones

> Mark releases, incidents, and process changes as vertical lines on your metric charts

## What are milestones?

Milestones are dated events that show up as vertical lines on timeline charts. Use them to explain changes in your metrics, so anyone reading a chart later knows why a number moved.

Common examples:

* A release freeze or blocked deploy that held back merges
* An incident or outage
* A holiday, offsite, or hackathon
* A process change, like a new review policy or rolling out an AI tool

Milestones don't change any metric values. They only add context to the chart.

## Scopes

Each milestone has one of three scopes:

* **Organization**: shown on organization-wide charts
* **Team**: shown on charts for a specific team
* **Individual**: shown on charts for a specific person

The scope can't be changed after a milestone is created. For team and individual milestones, you can change which team or person it applies to.

## Adding a milestone

1. Go to **Settings > General**
2. Under **Metrics & display defaults**, find **Milestones** and click **Configure**
3. Click **Add milestone**
4. Choose a scope, then enter a title, date, and optional description and color
5. Leave **Displayed** on to show the milestone to everyone by default

To edit or remove a milestone, open it from the same page.

## Showing or hiding milestones

Milestones are shown by default. To turn them on or off for your dashboards:

1. Click the dashboard settings icon in the top navigation bar
2. Open **Annotations**
3. Toggle **Show event milestones**

## Permissions

Adding, editing, and removing a milestone requires the same access as editing that scope's metrics:

* **Organization** milestones: managers and admins
* **Team** milestones: people who can edit that team's metrics
* **Individual** milestones: people who can view that person's data

You only see milestones for scopes you have access to.

## Related

* [Goal lines](https://docs.weaveos.com/annotations/goal-lines.md) for adding performance targets to charts
* [Benchmarks](https://docs.weaveos.com/annotations/benchmarks.md) for comparing against other companies


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.