GitLab Support
Once your license or subscription is provisioned, submit an initial ticket with a list of contacts who are allowed to contact Support. This can be done via Support Portal Related Matters Form (this link pre-fills out the appropriate problem type for you).
Depending on how you purchased GitLab, GitLab Support may not automatically detect your support entitlement on the creation of your first support ticket. If that's the case, your ticket might get a rejection message and direct you to this page.
If you are speaking to our Support Operations team, you might be asked to prove your entitlement using the information below.
To ensure that we can match you with your GitLab.com subscription when opening a support ticket, please:
- include your GitLab.com username; AND
- use the primary email address associated with your account; AND
- reference a path within a GitLab.com group (that you are a member of or attempting to join), which has a valid subscription associated with it (such as a link to a problematic pipeline or MR)
To ensure that we can match you with your Self-managed license when opening a support ticket, please:
- use a company provided email address (no generic email addresses such as Gmail, Yahoo, etc.); AND
- provide GitLab with one of the following:
- A screenshot of the license page
- versions older than 14.1 see
/admin/license
- versions 14.1 or newer see
/admin/subscription
- versions older than 14.1 see
- The output of the command
sudo gitlab-rake gitlab:license:info
- The license ID displayed on the /admin/license page (GitLab 13.2+)
- A screenshot of the license page
We currently offer two methods to manage your support contacts:
- Via ticket
- Done by submitting a Support Ops ticket
- This has a limit of 30 maximum contacts under your organization.
- Via a contact management project
- You and your team can manage support contacts via a YAML file in a special project on GitLab.com. See Contact management projects for more information.
- This has a limit of 50 maximum contacts under your organization.
Some organizations prefer to use a generic email address like an alias or distribution group for one of their registered support contacts. This will work, but for the smoothest experience consider the following:
- Set a login password for this support user and share it within your team.
- When you raise a ticket, always log in: this will allow you to add CCs to any tickets you raise.
- CC any email addresses that may be involved in the resolution of the ticket: this will allow other individuals in the organization to reply to the ticket via email.
For organizations that require additional security, you can specify a set of authorized contacts who can make changes.
- Submit a Support ticket using the Support portal related matters form and select Other requests in the Problem type field.
We will add an internal note detailing who is allowed to make changes to the contacts in your organization.
Contact management projects are a project on GitLab.com that allows you and your team to add and remove support contacts more quickly than through tickets.
At your request, our Support Operations team creates a collaboration project that is only accessible by the GitLab team and individuals you specify as allowed to manage the contacts.yaml file. When a commit is made, a webhook is triggered that then uses the project's contacts.yaml file to sync the first 50 contacts within the file to the customer's organization in the support portal.
You can tell if the sync is in a good state or not by looking at the project badge for your contact management project. It will detail if the sync has been successful or has encountered issues. If you do see it has encountered issues, please feel free to reach out to the Support Operations team via this link.
If you would like to speak to our Support Operations team about setting one of these up for you, please reach out via this link
Note This does not apply to US Federal customers whose contact handling happens in a system tailored to US Federal requirements.
Note The maximum number of developers that can be invited to manage the project's files is 5.
In some cases, certain organizations want all members of their organization to be able to see all of the support tickets that have been logged. In other cases, a particular user from the account would like to be able to see and respond to all tickets from their organization. If you'd like to enable this, please:
Global Support Shared Organization Setup
- Submit a Support ticket using the Global Support portal related matters form and select
Shared organization requests
in the Problem type field.
US Federal Support Shared Organization Setup
- Submit a Support ticket in the US Federal Support portal's requests for shared organization setup form and fill in what type of sharing you would like setup. Kindly note that if you wish to enable shared organizations in both portals you must submit a separate request using the Global Support portal form.
If there's a special set of handling instructions you'd like included in your Organizations notes, we'll do our best to comply. Not all requests can be accommodated, but if there is something we can do to make your support experience better we want to know.
- Submit a Support ticket using the Support portal related matters form and select
Other Requests
in the Problem type field.