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
- Go to Settings > General
- Under Metrics & display defaults, find Milestones and click Configure
- Click Add milestone
- Choose a scope, then enter a title, date, and optional description and color
- 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:
- Click the dashboard settings icon in the top navigation bar
- Open Annotations
- 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.
- Goal lines for adding performance targets to charts
- Benchmarks for comparing against other companies
Last modified on November 10, 2026