Viewing license usage for GitHub Enterprise

You can view license usage for your enterprise on GitHub Enterprise Cloud.

Who can use this feature?

Enterprise owners and billing managers

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 license usage for GitHub Enterprise

You can view license usage for GitHub Enterprise Cloud on GitHub.

If you use both GitHub Enterprise Cloud and GitHub Enterprise Server and sync license usage between the products, you can view license usage for both on GitHub Enterprise Cloud. For more information about license sync, see "Syncing license usage between GitHub Enterprise Server and GitHub Enterprise Cloud."

You can also use the REST API to return consumed licenses data and the status of the license sync job. See "REST API endpoints for enterprise licenses."

To learn more about the license data associated with your enterprise account and how the number of consumed user licenses are calculated, see "Troubleshooting license usage for GitHub Enterprise."

Viewing license usage on GitHub Enterprise Cloud

You can view the license usage for your enterprise and download a file with license details. If you're not seeing expected license counts in this report, it's possible that the subscriber’s assigned Visual Studio subscription email address and GitHub.com email address aren't exactly the same. For further information, see "Troubleshooting license usage for GitHub Enterprise."

  1. Navigate to GitHub Enterprise Cloud.

  2. In the top-right corner of GitHub, click your profile photo, then click Your enterprises.

  3. In the list of enterprises, click the enterprise you want to view.

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

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

  6. Review your current GitHub Enterprise license, as well as consumed and available user licenses.

  7. To download a CSV report of the license usage, click to the right of the usage you want to download, then click CSV report.

Viewing the last license sync date

  1. Navigate to GitHub Enterprise Cloud.

  2. In the top-right corner of GitHub, click your profile photo, then click Your enterprises.

  3. In the list of enterprises, click the enterprise you want to view.

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

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

  6. To identify when the last license sync occurred, under "Enterprise Server instances", look for timestamps next to usage uploaded or synced events.

    • "Server usage uploaded" indicates license usage between environments was manually updated when a GitHub Enterprise Server license file was uploaded.
    • "GitHub Connect server usage synced" indicates license usage between environments was automatically updated.
    • "GitHub Connect server usage never synced" indicates that GitHub Connect is configured, but license usage between environments has never updated successfully.