License usage

{{< details >}}

• Tier: Premium, Ultimate
• Offering: GitLab Self-Managed

{{< /details >}}

You can view the usage associated with your GitLab license and export the license usage file with the following information:

• License key
• Licensee email
• License start date (UTC)
• License end date (UTC)
• Company
• Timestamp the file was generated at and exported (UTC)
• Table of historical user counts for each day in the period:
  • Timestamp the count was recorded (UTC)
  • Billable user count

[!note] A custom format is used for dates and times in CSV files.

Export license usage

Prerequisites:

• You must be an administrator.

You can export your license usage into a CSV file.

This file contains the information GitLab uses to manually process quarterly reconciliations and renewals. If your instance is firewalled or an offline environment, you must provide GitLab with this information.

[!warning] Do not open the license usage file. If you open the file, failures might occur when you submit your license usage data.

1. In the upper-right corner, select Admin.
2. Select Subscription.
3. In the upper-right corner, select Export license usage file.