Managing your spending limit for GitHub Packages

You can set a spending limit for GitHub Packages usage.

Who can use this feature?

GitHub Packages is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server 3.0 or higher.


GitHub Packages is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access registries that support granular permissions, because these accounts are billed by repository. Enterprise Managed Users do not have individual storage allocation to publish packages within their account's namespace, but can publish to an organization's namespace. For additional information on Enterprise Managed Users, see About Enterprise Managed Users. For the list of registries that support granular permissions, see About permissions for GitHub Packages. For more information, see GitHub’s plans.

In this article

Note

Enterprise accounts, and organizations owned by enterprise accounts, created after June 2, 2024, have access to the enhanced billing platform. Enterprises that participated in the public preview program also have access to the enhanced billing platform.

The enhanced billing platform offers better spending control and detailed visibility to help you understand your usage with more granular controls. See "Using the new billing platform."

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 or enterprise owner, you can connect an Azure Subscription ID to your organization or 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.

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.

    Screenshot of the summary section of the billing settings page. On the right, "Manage spending limit" is highlighted with a dark orange outline.

  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.

    Screenshot of the summary section of the billing settings page. On the right, "Manage spending limit" is highlighted with a dark orange outline.

  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 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.

  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 Settings.

  4. Under Settings, click Billing.

  5. On the "Billing" page, click the Spending limit tab.

    Screenshot of the "Billing" page. A tab labeled "Spending limit" is highlighted with an orange outline.

  6. Scroll down to "Actions & Packages" and 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.