Viewing the subscription and usage for your enterprise account

You can view the current subscription, license usage, invoices, payment history, and other billing information for your enterprise account.

Who can use this feature?

Enterprise owners and billing managers can access and manage all billing settings for enterprise accounts.

In this article

Note

Enterprise accounts, and organizations owned by enterprise accounts, created after June 2, 2024, have access to the enhanced billing platform. Enterprises that participated in the public preview program also have access to the enhanced billing platform.

The page to view license usage has moved in the enhanced billing platform. See "Gathering insights on your spending."

About billing for enterprise accounts

You can view an overview of your subscription and paid usage for your enterprise account on GitHub.com. If you currently use GitHub Enterprise Cloud with a single organization, we encourage you to create an enterprise account. For more information, see "Creating an enterprise account."

For invoiced GitHub Enterprise customers, each invoice includes details about billed services for all products. For example, in addition to your usage for GitHub Enterprise Cloud, you may have usage for GitHub Advanced Security, paid licenses in organizations outside of your enterprise account, data packs for Git Large File Storage, or subscriptions to apps in GitHub Marketplace. For more information about invoices, see "Managing invoices for your enterprise."

In addition to enterprise owners, billing managers can view the subscription and usage for your enterprise account. For more information, see "Roles in an enterprise" and "Inviting people to manage your enterprise."

You can connect an Azure Subscription ID to your enterprise account to enable and pay for any usage-based billing for GitHub. For example, GitHub Codespaces usage, and for GitHub Actions or GitHub Packages usage, beyond the amounts included with your account. For more information, see "Connecting an Azure subscription."

If you created a trial of GitHub Enterprise Cloud on or after August 1, 2024, you use usage-based billing to pay for your licenses. With usage-based billing, you pay for the number of licenses you use each month. You do not need to buy a predefined number of licenses in advance. See, "About usage-based billing for licenses."

Important

If you currently pay for your GitHub Enterprise licenses through a volume, subscription, or prepaid agreement, you will continue to be billed in this way until your agreement expires. At renewal, you have the option to switch to the metered billing model. See "Getting started with the new billing platform."

Viewing the subscription and usage for your enterprise account

You can view the subscription and usage for your enterprise and download a file with license details.

If your license includes Visual Studio subscriptions with GitHub Enterprise, you can identify whether a user account on GitHub.com has successfully matched with a Visual Studio subscriber by downloading the CSV file that contains additional license details. The license status will be one of the following.

  • "Matched": The user account on GitHub.com is linked with a Visual Studio subscriber.
  • "Pending Invitation": An invitation was sent to a Visual Studio subscriber, but the subscriber has not accepted the invitation.
  • Blank: There is no Visual Studio association to consider for the user account on GitHub.com.

  1. In the top-right corner of GitHub, click your profile photo.

  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.

  3. On the left side of the page, in the enterprise account sidebar, click Settings.

  4. Under Settings, click Licensing.

    Note

    If you are on the enhanced billing platform, the licensing page has been relocated. See "Gathering insights on your spending."

  5. Under "User licenses", view your total licenses, number of consumed licenses, and your subscription expiration date.

  6. Optionally, to view details for license usage or download a CSV file with license details, to the right of "User Licenses", click View details or CSV report.

  7. Optionally, to view usage details for other features, in the left sidebar, click Billing.