Skip to main content

Viewing license usage for GitHub Enterprise

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

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 "GitHub Enterprise administration" in the REST API documentation.

To learn more about the license data associated with your enterprise account and how the number of consumed user seats 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. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  3. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  4. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  5. In the left sidebar, click Enterprise licensing. "Enterprise licensing" tab in the enterprise account settings sidebar

  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. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  3. In the list of enterprises, click the enterprise you want to view. Name of an enterprise in list of your enterprises

  4. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  5. In the left sidebar, click Enterprise licensing. "Enterprise licensing" tab in the enterprise account settings sidebar

  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.