Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Delivery of license files


The support team is responsible for generating licenses when the automated systems are unable to do so or an error is made. This is done via CustomerDot and the Licenses section.

Generating a license may originate from an internal request or may be a required action to help move a support ticket forward.

In both cases the license will be emailed to the customer directly after creation. Unless the circumstances require, we should not send the licenses to any GitLab employee. Exceptions may include air-gapped installs or other situations where the customer cannot receive the license via the email.

Note that a license should always be generated with the end-user email address. A license should not be generated with reseller or GitLab team member details if the license is for a customer.

Where does a license get sent to?

There is often confusion about the email address that the license will be delivered to and how to ensure the correct email address receives the license.

The license will send to the sold-to contact (in Zuora) with the initial sale. All subsequent licenses will go to the contact in the CustomersDot customer record associated with the subscription. So if the customer changed the email in CustomerDot, subsequent licenses will go to that email address.

In the event of two CustomerDot accounts associated with the same subscription, the system will try to find the customer record in CustomerDot based on two fields from the Zuora Account: sold to contact email and zuora account id. For the person who's CustomerDot email address matches the Sold to contact email address, the license will be sent to them. A Zuora Sold to contact change, together with updating the CustomersDot email address to match, will ensure a new contact gets future licenses delivered to them.

If neither CustomerDot email addresses match the Sold to contact email address, the account ID is used in the lookup. It’s important to note that when querying by Zuora Account ID we aren't specifying an order to the SQL query, hence we don’t have any guarantee about the order in which the record will be returned (i.e the license could be sent to either email address).

Code reference and issue thread for more detail.

Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license