---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Onboard GitLab using Workspace

# Onboard GitLab to DevOps Change Velocity --- Workspace {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read  
Connect to your GitLab instance using the DevOps Change Workspace playbook to discover plans, repositories, and pipelines.

## Before you begin

Complete the tasks specified in the [Getting started with DevOps Change Velocity](https://servicenow-prod.fluidtopics.net/zYfXM71OMizgQDlC6XiIiA "Learn about the setup process for DevOps Change Velocity that is required before configuring integrations with your toolchain.") topic.

Role required: sn_devops.admin or sn_devops.tool_owner

## Procedure

1. Navigate to WorkspacesDevOps Change Workspace and use one of the following options to open the Playbook to onboard GitLab.

   | Option | Steps |
   | Homepage | 1. Select Connect a tool. 2. From the Connect to a tool modal, select the tool from the appropriate category. For example, if you want to connect to GitLab as coding tool, you'd select GitLab under the Code category. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_e5j_4y1_fwb} |
   | Applications module | 1. Select Applications (![Applications icon.]()) from the primary navigation. 2. Select an existing application, or create one. To create an application, see [Create an application - Workspace](https://servicenow-prod.fluidtopics.net/0Q3U7QvoyazFAJLrEFh1bg "Create applications using the DevOps Change Workspace and associate pipelines, plans, and repositories to it."). 3. From the  Recommended actions  pane, select the  Connect a tool  card. 4. From the Connect to a tool modal, select the tool from the appropriate category. For example, if you want to connect to GitLab as coding tool, you'd select GitLab under the Code category. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_u24_mz1_fwb} |
   | Tools module | 1. Select Tools (![Tools icon.]()) from the primary navigation. 2. From the Capability list, select the appropriate category. For example, if you want to connect to GitLab as coding tool, you'd select the Coding category. 3. Select Connect a tool. 4. On the  Connect to a tool  modal, select GitLab. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_fjs_k1b_fwb} |
   |-|-|

   {#onboard-gitlab-to-devops-change-velocity-workspace__choicetable_m3t_ky1_fwb}  
   Important:  
   If you want to discover and track tool objects like plans, pipelines, or repositories while connecting to the tool, you must connect your tool from the Application module.
2. In the Tool name field, enter a name for the tool.  
3. Select Next.  
   The DevOps playbook opens to help you complete the onboarding tasks.
4. Enter your GitLab instance details.
   1. Enter your GitLab instance URL.
   2. In the Credential type field, select one.  
      * Basic Auth
      * OAuth 2.0
      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_uvd_2dg_fwb}
   3. Enter the credentials.  
      * Basic Auth: Enter the username and password/access token of your GitLab instance.  
        Note:  
        Only personal access token is supported. When you generate the token, select the scope API and grant read/write access including all the groups and projects, container registry, and package registry.
      * OAuth 2.0: Enter your OAuth credential.For more information on OAuth2.0 credentials, see [Setting up GitLab OAuth 2.0 credentials for DevOps](https://servicenow-prod.fluidtopics.net/gq~ms6f3HGmhxZ2tj9_X~w#setting-up-gitlab-oauth "Integrate your GitLab account with your ServiceNow instance by creating a custom OAuth application in GitLab and authenticating requests from ServiceNow DevOps.").

      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_tjv_gdg_fwb}
   4. **Optional:** If your GitLab instance is attached to a MID Server, select the MID Server option and enter its details.  
      For more information about MID server, see [MID Server selection](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)
   5. Select Connect.  
   {#onboard-gitlab-to-devops-change-velocity-workspace__substeps_wdp_x1b_fwb}
5. Permission checks are run on the credentials that you entered.  
   Permissions required and permissions that are available are displayed. If you want to enter credentials with better permissions, select Re-enter credentials. For detailed information on all the required permissions, see GitLab permissions in [Permissions required for DevOps tools](https://servicenow-prod.fluidtopics.net/rkQZOOxQSNdDZ7d5eHch0A "Permissions required in your third-party tool to connect to DevOps Change Velocity.").

   You can choose to continue with the tool connection even if you don't have all the required permissions.

6. Select Next.
7. Specify the access for the tool.  
   1. If you want to control access to the tool, add the groups that must be given access to the tool in the Maintained by field.  
      The tasks these users in the groups can perform depends on the role assigned to them.
      * DevOps Tool Owner role: Can view and edit the tool.
      * DevOps App Owner role: Can view the tool and can associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's objects (such as plans, repositories, and pipelines).
      * DevOps Administrator role: Can edit all tools.
      * Other DevOps roles: Can view the tool.
      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_csp_h5c_xwb}  
      Note:  
      If you don't select a group and skip this step, all users with the DevOps Tool Owner role will be able to edit the tool.
   2. If you choose to control access to the tool, the All App Owners can view and associate tool objects to applications option becomes available for selection.

      This option enables all users having
      the DevOps App Owner role to access the tool. If selected, they'll be able to view, associate, discover, import historical data, and modify pipeline steps (if applicable) of the tool's objects.
   3. Select Assign.

   {#onboard-gitlab-to-devops-change-velocity-workspace__ol_slg_2tz_cxb}

8. Select the projects for which you want to configure webhooks automatically.  
   You can also choose to enable nightly polling to retrieve data for any tracked pipelines by selecting the Enable Polling property option in the Administration module. See [DevOps Change Velocity properties](https://servicenow-prod.fluidtopics.net/Cy67V7Lf9sOXU2beB3VARQ "Use these properties to configure settings in the DevOps Change Velocity application.").
9. Select Configure.  

   To configure manually, select Configure manually. See [Configure webhooks in GitLab manually](https://servicenow-prod.fluidtopics.net/Df_ukaE_J14LfMJ27V6S0Q "Configure webhooks in GitLab manually to send job, push, and issues notifications to the DevOps application.") for more information.  
   Important:  
   * If you're connecting from the Home page or Tools module, the connection is complete and you're taken to the Summary page.
   * If you're connecting from the Applications module, then plans, repositories, and pipelines available in your project are discovered. You can track and import historical data from them.
   {#onboard-gitlab-to-devops-change-velocity-workspace__ul_yfy_zz1_bzb}
10. Select the pipelines that you want to associate to the application, and select Associate pipelines.  
    For each selected pipeline, all steps are imported for the last successful execution.
11. **Optional:** In the Assign services to pipeline steps activity, specify Step type and Service for each pipeline step.  
    Completing this step as part of tool onboarding enables the DevOps Insights dashboards to show more meaningful data immediately.
12. Select the plans you want to associate to the application, and select Associate plans.
13. Select the repositories you want to associate to the application, and select Associate repositories.
14. In the Import historical data step, select the date range in the Start date and End date fields and select Import data.  
    Note:  
    You can import up to 90 days of data.
15. Select Next.
16. From the Summary page, review the details of the successfully connected GitLab tool.  
    Select View tool record to review the details of the connected instance.

## Result

You've successfully onboarded your GitLab tool to DevOps Change Velocity.  
Note:  
If your tool credential changes, you must also update the credentials in DevOps Change. For more information, see [Update third-party tool credentials in DevOps Change Velocity](https://servicenow-prod.fluidtopics.net/W3H0I3eiOCLVglPK635qzA "If your tool credential has changed, you must update the credentials in your ServiceNow instance to avoid getting disconnected.").
**Related tasks**   

* [Configure webhooks from the tool record](https://servicenow-prod.fluidtopics.net/xBCT3l6udjf2J51Iy9PfSw "Configure webhooks from the tool record to send data to DevOps Change Velocity after your tool is connected.")

*[\>]: and then