Skip to main content

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. For the list of registries that support granular permissions, see "About permissions for GitHub Packages." For more information, see "GitHub’s plans."

About spending limits for GitHub Packages

GitHub Packages usage is free for public packages. For private packages, each account on GitHub.com 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, click your profile photo, then click Settings.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

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

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  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 usage and spending limit email notifications

Email notifications are sent to account owners and billing managers when spending reaches 50%, 75%, 90% and 100% of your account's included usage and when spending reaches 50%, 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.