Skip to main content

Managing spending limits for GitHub Codespaces

You can set a spending limit for GitHub Codespaces usage.

GitHub Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. GitHub Codespaces is also available as a limited beta release for individual users on GitHub Free and GitHub Pro plans. For more information, see "GitHub's products."

About spending limits for GitHub Codespaces

Note: You must set a non-zero spending limit before you can use GitHub Codespaces.

By default, your organization or enterprise will have a GitHub Codespaces spending limit of $0. This prevents new codespaces from being created, or existing codespaces from being opened, if this would incur a billable cost to your organization or enterprise. To allow your users to create codespaces in your organization, set the limit to a value higher than $0.

Overages are always billed monthly regardless of your billing term (even if your account is otherwise billed annually).

Once you've reached your spending limit, your organization or repository will no longer be able to create new codespaces, and won't be able to start existing codespaces. Any existing codespaces that are still running will not be shutdown; if you don't change the spending limit, you will not be charged for the amount that exceeds the limit.

For more information about pricing for GitHub Codespaces usage, see "About billing for GitHub Codespaces."

Managing the spending limit for Codespaces for your organization

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

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

    Settings icon in the user bar

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

  3. Next to the organization, click Settings. The settings button

  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. Manage spending limit link

  6. Under "Monthly spending limit", scroll down to "Codespaces" and choose to limit spending or allow unlimited spending. Radio buttons to limit spending or allow unlimited spending

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

Exporting changes when you have reached your spending limit

If you hit a spending limit, you will no longer be able to create or resume your codespaces. You can still export any work in progress changes to a new branch.

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

You can disable these notifications anytime by navigating to the bottom of the Spending Limit page.

Screenshot of the billing email notification settings

Further reading