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.
- In the top-right corner of GitHub, click your profile photo.
- Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
- On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.
- Click Budgets and alerts.
- 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.
-
In the top-right corner of GitHub, click your profile photo.
-
Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
-
On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.
-
Click Budgets and alerts.
-
Click New budget.
-
Under "Products", select the metered product to include in this budget.
-
Under "Budget scope", set the scope of spending for this budget.
-
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.
-
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.
-
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.
- In the top-right corner of GitHub, click your profile photo.
- Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
- On the left side of the page, in the enterprise account sidebar, click Billing & Licensing.
- To edit a budget, in the list of budgets, click next to the budget you want to edit, and click Edit or Delete.
- Follow the prompts.