Viewing subscription and usage for your enterprise
You can view the subscription and usage for your enterprise and download a file with license details.
- In the top-right corner of GitHub, click your profile picture.
- Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
- At the top of the page, click Billing and licensing.
- Click Licensing to show detailed information on license use.
The information displayed varies according to your enterprise set up.
- GitHub Enterprise Cloud, potentially with licenses synchronized from GitHub Enterprise Server
- GitHub Enterprise Server
To learn more about the license data associated with your enterprise account and how the number of consumed user licenses is calculated, see Troubleshooting license usage for GitHub Enterprise.
Finding information on GitHub Enterprise Cloud
- Under "User licenses", view your total licenses, number of consumed licenses, and your subscription expiration date.
- 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.
- To view usage details for other features, in the left sidebar, click Billing.
Synchronization of GitHub Enterprise Server use
The date of the last license sync occurred is shown 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.
For more information, see Syncing license usage from GitHub Enterprise Server to Cloud.
Synchronization of Visual Studio subscriptions with GitHub Enterprise subscriptions
If your GitHub license includes Visual Studio subscriptions with GitHub Enterprise, you can identify whether a user account on GitHub Enterprise Cloud 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.
Finding information on GitHub Enterprise Server
- Under "User licenses", view your total licenses, number of consumed licenses, and your subscription expiration date.
- To view details for license usage or download a JSON file with license details, click View users or Export license usage.
- Review your current GitHub Enterprise license, as well as consumed and available user licenses.
- If you have purchased Advanced Security, you can review your total licenses used as well as a per-organization breakdown of active committers. See Configuring infrastructure for GitHub Advanced Security features.
Reporting license information using the REST API
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.