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 account on GitHub receives a certain amount of free storage and data transfer, depending on the account's plan. 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 US dollars (USD), 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 (any usage beyond the amounts included with your plan) for GitHub Packages and GitHub Actions. For more information about pricing for GitHub Packages usage, see About billing for GitHub Packages.

If you are an organization owner, you can connect an Azure Subscription ID to your organization account to enable and pay for GitHub Packages usage beyond the amounts including with your account. For more information, see Connecting an Azure subscription.

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 personal account

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

1. In the upper-right corner of any page on GitHub, click your profile photo, then click Settings.

2. In the "Access" section of the sidebar, click Billing and plans, then click Plans and usage.

3. At the top of the page, under "Payment information," click Manage spending limit.

   

4. Scroll down to "Actions & Packages" and choose to limit spending or allow unlimited spending.

5. Depending on which option you chose, click either Update limit or Update to unlimited.

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 on GitHub, click your profile photo, then click Settings.

2. In the "Access" section of the sidebar, click Organizations.

3. Next to the organization, click Settings.

4. If you are an organization owner, in the "Access" section of the sidebar, click Billing and plans.

5. At the top of the page, under "Payment information," click Manage spending limit.

   

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

   Note

   If GitHub Codespaces is enabled for your organization, scroll to "Actions & Packages", then choose to limit spending or allow unlimited spending.

7. Depending on which option you chose, click either Update limit or Update to unlimited.

Managing usage and spending limit email notifications

Email notifications are sent to account owners and billing managers when spending reaches 75%, 90% and 100% of your account's included usage and when spending reaches 75%, 90%, and 100% of your account's spending limit.

You can disable these notifications at any time by navigating to the "Email alerts" section at the bottom of the "Spending limit" page.