Skip to main content

Viewing your GitHub Codespaces usage

You can view the compute hours and storage used by GitHub Codespaces.

Viewing GitHub Codespaces usage for your personal account

You can see how much of the usage included in your personal account you have used so far in the current monthly billing cycle. If you have set up a payment method, set a spending limit, and used all of your included usage, you can also check your bill for the current month.

  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. Under "Codespaces," you can see how many core hours of GitHub Codespaces compute usage and GB-months of storage you have used so far in the current billing month.

    Screenshot of the "Codespaces" section of the billing page showing figures for "Usage hours" and "Storage."

    For information about "core hours" and "GB-months," see "About billing for GitHub Codespaces."

  4. Optionally, click Usage hours and Storage to see more details.

    Screenshot of the "Codespaces" section of the billing page, expanded to show more details for "Usage hours" and "Storage."

    The Included column shows how many of the core hours of compute usage, or GB-months of storage, included free with your account, you have used so far this month. The Paid column shows how many billed core hours of usage, or GB-months of storage, you have used. The figures are updated once every hour.

    In the screenshot above, the entire quota of included storage for the month has been used. When you've used all of either the included compute usage or storage (whichever is reached first), you must set up a payment method and a spending limit to continue using GitHub Codespaces during the current billing month. See "Adding or editing a payment method" and "Managing the spending limit for GitHub Codespaces."

    For tips on making your allowed usage go further, see "Getting the most out of your included usage."

  5. Optionally, next to "Usage this month", click Get usage report to get an email containing a link for downloading a CSV report of storage use for GitHub Actions, GitHub Packages, and GitHub Codespaces. The email is sent to your account's primary email address. You can choose whether the report should cover the last 7, 30, 90, or 180 days.

    Screenshot of the "Billing and plans" settings. A button, labeled "Get usage report", is highlighted with an orange outline.

    The data used for this report is updated daily.

    To see the costs for GitHub Codespaces compute usage and storage, filter the report to show only rows that mention "Codespaces" in the Product column.

    Screenshot of a usage report filtered to show only row that mention "Codespaces" in the "Product" column.

    To see only the costs for creating, updating and storing prebuilds, filter the report to show only rows that mention "Create Codespaces Prebuilds" in the Actions Workflow column.

    Screenshot of a usage report filtered to show only details relating to codespace prebuilds.

Viewing GitHub Codespaces usage for your organization account

Organization owners and billing managers can view GitHub Codespaces usage for the 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. Under "Usage this month", under "Codespaces", view the details of the compute hours and storage used so far this month.

    Notes:

    • The costs shown here are the cumulative costs within the current billing month. The usage-based costs for GitHub Codespaces shown on this page are reset to zero at the start of each billing month. Outstanding costs from previous months are not shown.
    • The figures on this page are updated every hour.

    You can also see and update your current spending limit. See "Managing the spending limit for GitHub Codespaces."

    The Projected usage figure gives an estimate of the total usage for the current billing month, assuming the compute and storage usage for the past seven days continues unchanged for the remainder of the billing month. See "About billing for GitHub Codespaces."

  6. Optionally, next to "Usage this month", click Get usage report to get an email containing a link for downloading a CSV report of storage use for GitHub Actions, GitHub Packages, and GitHub Codespaces. The email is sent to your account's primary email address. You can choose whether the report should cover the last 7, 30, 90, or 180 days.

    Screenshot of the "Billing and plans" settings. A button, labeled "Get usage report", is highlighted with an orange outline.

    The data used for this report is updated daily.

    To see the costs for GitHub Codespaces compute usage and storage, filter the report to show only rows that mention "Codespaces" in the Product column.

    Screenshot of a usage report filtered to show only row that mention "Codespaces" in the "Product" column.

    To see only the costs for creating, updating and storing prebuilds, filter the report to show only rows that mention "Create Codespaces Prebuilds" in the Actions Workflow column.

    Screenshot of a usage report filtered to show only details relating to codespace prebuilds.

Further reading