Skip to main content

Preventing overspending

Learn how to set budgets and track when they are nearing or above a threshold to prevent overspending.

Who can use this feature?

The new billing platform is available to all enterprise accounts, and their organizations, created after June 2, 2024. Enterprises that participated in the public preview program also have access to the new billing platform.

Beginning in September 2024, GitHub will migrate remaining enterprises to the new billing platform. Enterprises will receive a notice 30 days before their migration. See the GitHub blog.

Budgets and alerts allow you to track spending for your enterprise, organizations, repositories, or cost centers. By setting a monthly budget, you can monitor your spending and receive notifications by email when your spending exceeds certain preset percentages of your budget threshold. This can help you stay within your budget and avoid overspending.

The budget only applies to expenses incurred from the date of its creation onwards. Any expenses incurred prior to the creation of the budget will not be included in the calculations

Budgets are not applicable to:

  • Seat-based products such as GitHub Copilot, GitHub Advanced Security, and GitHub Enterprise.
  • Pre-paid volume licenses.

Viewing budgets

If you are an enterprise owner or billing manager, your enterprise's budget will be listed at the top of the "Budgets and alerts" page, followed by the budgets for your organizations and cost centers. As an organization owner, you will be able to view the budgets for your organizations, repositories, and cost centers.

  1. In the top-right corner of GitHub, click your profile photo.
  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
  3. On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.
  4. Click Budgets and alerts.
  5. To filter by scope, select Scope, then choose a scope.

Creating a budget

As an enterprise owner or billing manager, you can set the budget for your enterprise, an organization within your enterprise, or a cost center. As an organization owner, you are able to set the budgets for the repositories you manage.

  1. In the top-right corner of GitHub, click your profile photo.

  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.

  3. On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.

  4. Click Budgets and alerts.

  5. Click New budget.

  6. Under "Products", select the metered product to include in this budget.

  7. Under "Budget scope", set the scope of spending for this budget.

  8. Under "Budget", set a budget amount.

    To stop any usage and further spending once your enterprise or organization reaches the budget limit, select Stop usage when budget limit is reached. This does not apply to GitHub Copilot usage.

    Important

    If you do not select Stop usage when budget limit is reached, you will be notified by email if you exceed your budget, but usage will not be stopped.

  9. To receive an alert if your budget has reached 75%, 90% and 100% thresholds, select Receive budget threshold alerts under "Alerts". When the budget has reached the specific threshold, you will be notified via email and a banner on GitHub. You may opt out at any time.

    Under "Alert Recipients", select the people who will receive the alerts.

  10. Click Create budget.

Editing or deleting a budget

You can edit or delete a budget at any time, but you cannot change the budget scope.

  1. In the top-right corner of GitHub, click your profile photo.
  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
  3. On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.
  4. To edit a budget, in the list of budgets, click next to the budget you want to edit, and click Edit or Delete.
  5. Follow the prompts.