Skip to main content

Viewing license usage for GitHub Enterprise

You can view license usage for your enterprise on GitHub.com.

Who can use this feature?

Enterprise owners can view license usage for GitHub Enterprise.

About license usage for GitHub Enterprise

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

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.com. 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. For more information, 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.com

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

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

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

  4. In the enterprise account sidebar, click Settings.

  5. Under Settings, click Enterprise licensing.

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

Viewing the last license sync date

  1. Navigate to GitHub.com.

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

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

  4. In the enterprise account sidebar, click Settings.

  5. Under Settings, click Enterprise licensing.

  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.