This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2020-11-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Managing goals

You can use goals to set targets for key metrics and measure success reaching those targets.

Anyone with access to GitHub Insights can manage goals.

GitHub Insights is available with GitHub One. For more information, see "GitHub's products."

In this article

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.

About goals

Goals are targets that you can set for key metrics to measure your team's success. When you set a goal for a key metric, you can see how your team's performance compares to the goal using the goal line on charts and the success rate metric. For example, you can set the goal for code review turnaround time to 4 hours. A goal line on the key metric chart shows which code reviews achieved the goal and which did not. If your team completed one half of code reviews in less than 4 hours, your success rate will be 50%.

Goals are only available in key metrics. Some reports also show which work, such as individual pull requests, did not meet your goal. For more information, see "Viewing key metrics and reports."

Goals cannot be created or deleted. When you edit a goal, the new goal applies to everyone using your GitHub Insights application.

Editing a goal

  1. In GitHub Insights, click Key metrics.
    Key metrics tab
  2. Under Key metrics, click the name of the metric you want to view.
    List of key metrics
  3. To the right of the goal, click .
    Gear icon to edit goal
  4. In the text field, type a new goal value.
    Goal value field
  5. Click Save.
    Save goal

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.