Skip to main content

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.
  • Goal lines for adding performance targets to charts
  • Benchmarks for comparing against other companies
Last modified on November 10, 2026