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

Servicing Internal Requests

On this page

This document details the various workflows that should be followed in order to properly service requests that we receive in the internal-requests issue tracker along with which template to use if you need to open an issue in it yourself to document an action taken on a user or group. First, it will go over the general workflow you should follow when faced with a new issue in internal-requests and then it will inform you how to perform the specific tasks required to process each type of request.

General Workflow

Plan Change Requests & Trial Extensions

graph TD; A[Issue Created]-->B[Assign Yourself]; B-->C[Issue Actionable?]; C-->J[No]; J-->K[Apply Status::Blocked and Inform Submitter]; C-->D[Yes]; D-->E[Adjust Namespace via Customers Portal]; E-->F[Did it Work?]; F-->G[Yes]; G-->H[Note Issue and Close]; F-->I[No]; I-->L[Locate Error in Sentry]; click L "" "Diagnose Errors on" L-->M[Adjust Namespace Manually]; M-->N[Apply Status::On Hold, Set Due Date, and Inform Submitter];

SE Escalations

graph TD; A[Issue Created]-->B[Assign Yourself]; B-->C[Issue Actionable?]; C-->E[Yes]; E-->F[Action]; F-->G[Issue Resolved?]; G-->H[Yes]; H-->I[Apply Status::Awaiting Confirmation and inform submitter]; G-->L[No]; L-->M[Escalate]; C-->J[No]; J-->K[Apply Status::Blocked label and inform submitter];

Trial Extensions

Sales will often request that we extend the duration of trials on behalf of their prospects. These issues will always have the Trial Extension label applied to them and the following workflow should be followed to service them.

If any fields in the issue description were filled out incorrectly by the submitter apply the Status::Blocked label and mention them in the issue asking them to supply any missing information.

  1. Assign yourself to the issue.
  2. Check over the request and ensure that we've been provided enough information to action the request. To do this check that:
    1. The Link to Namespace: field contains a valid link to the namespace that holds the active trial. This should not be a Salesforce link or email address.
    2. The Extend Until: field contains a future date.
  3. Check to ensure that the namespace is currently on an active Gold trial. This process varies depending on whether you're dealing with a personal or group namespace.
    • Personal namespaces: Impersonate the user and navigate to their billing page.
    • Group namespaces: Navigate to Settings -> Billing within the group.
  4. Using the address provided in the Contact Email: field log into the Customers Portal as an administrator, input the email address into the search field, and search.
  5. Navigate to the GitLab Groups section of the entry for the customer.
  6. Adjust the subscription type and expiration date of the correct namespace according to the details of the issue using the Plan and Trial columns.
  7. Click Update.
  8. Set the due date of the issue to the value of what was provided in the Extend Until: field.
  9. Revert the subscription type of the namespace back to Free on the due date.

Repo Size Limit Increases

Should a user request a temporary extension of the size limit of their repository the following workflow should be used if that extension is granted.

  1. Open an issue in the internal-requests issue tracker using the Repo Size Limit issue template.
  2. Using your admin account navigate to the project in question while appending /edit to the URL. For example, if the project in question is located at you would navigate to
  3. Enter a new value in the Repository size limit (MB) field.
  4. Click Save changes.
  5. Revert the size limit back to the default of 10GB on the specified due date.

Soft-Deleted Project

Customers may ask that a project they recently marked for deletion be deleted immediately so that they can reuse that project's path without needing to wait. Should a customer request this through Zendesk, do the following.

  1. Open an issue in the internal-requests issue tracker using the Soft-Deleted Project issue template.
  2. Fill in the details of the template and submit the issue.
  3. Add a link to the issue to the Zendesk ticket and inform the customer that we've asked an engineer to process the deletion.

GitLab Gold Requests

Issues that come in with the GitLab Gold Request label require no action on our part as the process of granting Gold to the namespaces specified within them is entirely automated.

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