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

    Settings icon in the user bar

  2. In the "Access" section of the sidebar, click Billing and plans.

  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 initial view of personal usage

    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 expanded view of personal usage

    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. For more information, see "Adding or editing a payment method" and "Managing spending limits for GitHub Codespaces."

  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.

    Download CSV report

    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 for Codespaces

    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 for 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, 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. Under "Codespaces", view the details of the compute hours and storage used so far this month.

    Screenshot of compute usage and storage details

    You can also see and update your current spending limit. For more information, see "Managing spending limits for GitHub Codespaces."

    Notes:

    • The costs shown here are the cumulative costs within the current monthly billing period. The metered costs for GitHub Codespaces shown on this page are reset to zero at the start of each monthly billing period. Outstanding costs from previous months are not shown.
    • The figures on this page are updated every hour.
  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.

    Download CSV report

    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 for Codespaces

    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 for prebuilds

Further reading