Managing your spending limit for GitHub Packages

About spending limits for GitHub Packages

GitHub Packages usage is free for public packages. For private packages, each GitHub account receives a certain amount of free storage and data transfer, depending on the product used with the account. Any usage beyond the included amounts is controlled by spending limits.

If you are a monthly-billed customer, your account will have a default spending limit of $0, which prevents additional usage of storage or data transfer after you reach the included amounts. If you pay your account by invoice, your account will have an unlimited default spending limit.

You can set a specific spending limit or, for some accounts, allow unlimited spending. The spending limit applies to your combined overages for GitHub Packages and GitHub Actions. For more information about pricing for GitHub Packages usage, see "About billing for GitHub Packages."

If you purchased GitHub Enterprise through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for GitHub Packages usage beyond the amounts including with your account. For more information, see "Connecting an Azure subscription to your enterprise."

As soon as you set a spending limit other than $0, you will be responsible for any existing overages in the current billing period. For example, if your organization uses GitHub Team, does not allow overages, and publishes a new version of a private package that increases your storage usage for the month from 1.9GB to 2.1GB, publishing the version will use slightly more than the 2GB your product includes.

Because you have not enabled overages, your next attempt to publish a version of the package will fail. You will not receive a bill for the 0.1GB overage that month. However, if you enable overages, your first bill will include the 0.1GB of existing overage for the current billing cycle, as well as any additional overages you accrue.

Managing the spending limit for GitHub Packages for your user account

Anyone can manage the spending limit for GitHub Packages for their own user account.

1. In the upper-right corner of any page, click your profile photo, then click Settings.
2. In your user settings sidebar, click Billing & plans.
3. At the top of the page, under "Payment information", click Manage spending limit.
4. Under "Monthly spending limit", choose to limit spending or allow unlimited spending.
5. If you chose to limit spending, under "Limit spending", type a limit, then click Update limit.

Managing the spending limit for GitHub Packages for your organization

Organizations owners and billing managers can manage the spending limit for GitHub Packages for an organization.

1. In the upper-right corner of any page, click your profile photo, then click Settings.
2. In the settings sidebar, click Organizations.
3. Next to the organization, click Settings.
4. If you're an organization owner, in the left sidebar, click Billing & plans.
5. At the top of the page, under "Payment information", click Manage spending limit.
6. Under "Monthly spending limit", scroll down to "Actions & Packages" and choose to limit spending or allow unlimited spending.
7. If you chose to limit spending, under "Limit spending", type a limit, then click Update limit.

Managing the spending limit for GitHub Packages for your enterprise account

Enterprise owners and billing managers can manage the spending limit for GitHub Packages for an enterprise account.

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

2. In the list of enterprises, click the enterprise you want to view.

3. In the enterprise account sidebar, click Settings.

4. In the left sidebar, click Billing.

5. Above "GitHub Actions and Packages monthly usage", click Spending Limit.

6. Under "Monthly spending limit", choose to limit spending or allow unlimited spending.

7. If you chose to limit spending, under "Limit spending", type a limit, then click Update limit.