Skip to main content

Understanding billing for GitHub Codespaces

Learn how your GitHub Codespaces usage is billed.

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

This article explains how billing works for your codespaces, and explains how your organization's billing manager can help.

Getting access to GitHub Codespaces

Your organization's administrator might limit GitHub Codespaces usage to only specific personal accounts. To get access, you will need to contact your billing manager. For more information, see "Managing access to other repositories within your codespace."

How much it costs to use Codespaces

To see the pricing for GitHub Codespaces usage, see "About billing for GitHub Codespaces."

How your codespace usage is billed

Your codespace is billed for its compute minutes and for the amount of storage it uses on disk.

If you enable prebuilding of codespaces this will incur additional charges. For more information, see "About GitHub Codespaces prebuilds."

Understanding what compute minutes are

Your codespace is billed for the number of minutes that it's active. If your codespaces window is left idle for 30 minutes, it will automatically shutdown, and compute billing for the codespace will end until you start the codespace again.

Understanding how codespace storage is billed

For GitHub Codespaces, storage is defined to include any files relating to your codespace, such as the cloned repository, configuration files, and extensions, among others. This storage is billed while your codespace is shutdown. The storage billing for a codespace ends when you manually delete it from https://github.com/codespaces.

How spending limits work

Before your organization can use GitHub Codespaces, your billing manager will need to set a spending limit. For more information, see "Managing spending limits for GitHub Codespaces."

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.

Checking your current usage and limits

If you need to check your current usage or spending limit, contact your organization's billing manager. For more information, see "Viewing your GitHub Codespaces usage."

Codespaces can be automatically deleted

Your codespace will be automatically deleted when you are removed from an organization or repository.

Deleting your unused codespaces

You can manually delete your codespaces in https://github.com/codespaces and from within Visual Studio Code. To reduce the size of a codespace, you can manually delete files using the terminal or from within Visual Studio Code.

Further reading