---
sourceDocument: Australia ServiceNow AI Platform Administration
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/platform-administration

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# GitLab external content connector

# GitLab external content connector {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
The GitLab external content connector retrieves issues, wikis, merge requests, tags, branches, and commits from groups, projects, and repositories in your GitLab.com source system and makes their content and metadata searchable in AI Search applications.

Connector administrators can run
or schedule content crawls to retrieve updated content and access permissions from your source system, or user
permission crawls to retrieve updated security principals from your source system. Both types of crawl feed their data to AI Search for indexing.

The indexed content and metadata are stored as records in a connector-specific indexed source. Search administrators can create search sources from this
indexed source and link them to search profiles to make the indexed records searchable in AI Search applications.

## Prerequisites for the GitLab external content connector {#gitlab-external-content-connector__section_ztr_5q2_wfc}

To use the GitLab external content connector, your GitLab plan must satisfy all of these conditions:

Offering

:   You must be using the GitLab.com offering, not GitLab Dedicated or GitLab Self-Managed.

    To learn more about GitLab offerings, see <https://docs.gitlab.com/subscriptions/choosing_subscription/#choose-an-offering>.

Group owner user account
:   You need a GitLab.com user account that owns all the public and private top-level groups you want the external content connector to crawl. The connector impersonates this user when retrieving
    searchable content, user access permissions, and security principals from your GitLab source system.

Public content requirements
:   Public content you want to retrieve must be in public top-level groups owned by your group owner user.

Private content requirements

:   Private content you want to retrieve must be in a private top-level group on the Ultimate subscription tier. This group must be owned by your group owner user, and you must have configured access
    permissions for enterprise users in this private group. (The connector only retrieves user access permissions and security principals for enterprise users.)

    To learn more about GitLab subscription tiers, see <https://docs.gitlab.com/subscriptions/choosing_subscription/#choose-a-subscription-tier>. For information about GitLab enterprise users, see <https://docs.gitlab.com/user/enterprise_user/>.

## Limitations for the GitLab external content connector {#gitlab-external-content-connector__section_k31_yq2_wfc}

The GitLab external content connector doesn't retrieve searchable content from personal GitLab.com projects.  
When retrieving security principals from your GitLab.com source system, the GitLab external content connector doesn't support any of these security features:

* [Custom roles](https://docs.gitlab.com/user/custom_roles/)
* [Group access tokens](https://docs.gitlab.com/user/group/settings/group_access_tokens/)
* Users that aren't [Enterprise users](https://docs.gitlab.com/user/enterprise_user/)
* Users with the [Minimal Access](https://docs.gitlab.com/user/permissions/#users-with-minimal-access) role
{#gitlab-external-content-connector__ul_op1_1r2_wfc}
* **[Configure GitLab for external content indexing](https://servicenow-prod.fluidtopics.net/wyaFGNmYuXz_ruwlT2CRjQ)**   
  Create a personal access token for a group owner user account on GitLab.com to allow the GitLab external content connector to access your GitLab source system.
* **[Create a GitLab external content connector](https://servicenow-prod.fluidtopics.net/hBkxEqspGOa1xG2ZrhXQpQ)**   
  Create an external content connector to retrieve searchable content and security principals from your GitLab source system.
* **[Configure crawl settings for a GitLab external content connector](https://servicenow-prod.fluidtopics.net/bvIJuSgwIAATSfrY~s9WCA)**   
  Specify the groups, projects, and repositories you want your GitLab external content connector to crawl. Select the issues, wikis, merge requests, tags, branches, and commits you want the crawl to retrieve and feed to AI Search for indexing.

**Related tasks**   

* [Create a content crawl for an external content connector](https://servicenow-prod.fluidtopics.net/fFJ92ZYif96fkc2JA4HtyQ "Retrieve searchable content and metadata from your source system with a content crawl. Run the crawl as a one-time task or schedule it to run on a recurring basis.")
* [Create a user permission crawl for an external content connector](https://servicenow-prod.fluidtopics.net/mgt5mVce9bh_zJPIF3Xy5A "Retrieve security principals from your source system with a user permission crawl. Run the crawl as a one-time task or schedule it to run on a recurring basis.")