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

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Run a one-time user mapping crawl for an external content connector

# Run a one-time user mapping crawl for an external content connector {#ariaid-title1}

* Release version: Xanadu
* 
* Updated February 5, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Retrieve users and group access permissions from your external content connector's data source on demand. A user mapping crawl maps retrieved user and group permissions to your ServiceNow AI Platform® users to facilitate content security in your AI Search applications.

## Before you begin

Role required: ais_admin

## About this task

Create a one-time user mapping crawl when you want to retrieve updated users and group access permissions from a source system without configuring a scheduled crawl.  
Note:  
Some external content connectors don't retrieve user and group access permissions. You can't run user mapping crawls for these connectors.

* Predefined web sources external content connector
* ServiceNow documentation external content connector
* Slack external content connector

{#run-umap-crawl-ext-cont-connector__ul_whl_vpw_s2c}

The Atlassian
Confluence Cloud external content connector only maps permissions for Confluence Cloud users who have made their email addresses visible to all users. To allow user mapping, each Confluence Cloud user must set their own email visibility to Anyone as explained in the <https://support.atlassian.com/confluence-cloud/docs/configure-user-email-visibility/>
Atlassian support resource.

## Procedure

1. Navigate to AllExternal Content ConnectorsExternal Content Admin Home.
2. Select the record for the external content connector that you want to run a one-time user mapping crawl for.
3. Select Create crawls, then select Create one-time crawl.
4. In the Crawl settings dialog box, select User mapping crawl. {#run-umap-crawl-ext-cont-connector__select-ext-cont-doc-crawl-type}
{#run-umap-crawl-ext-cont-connector__select-ext-cont-doc-crawl-type}
5. Select Start.
{#run-umap-crawl-ext-cont-connector__steps_jvk_j3x_sdc}

## Result

The one-time user mapping crawl task is added to the crawl queue and runs when the system has availability.  
Note:  
To prevent excessive load on your instance, the External Content Connectors application only allows a maximum of five crawls to run simultaneously, no matter how many connectors you have created. Both content crawls and user permission crawls count against this limit. For best performance, run and schedule your external content connector crawls so that they don't overlap.

You can monitor the one-time crawl's state and results from the Connector list, or examine the external content connector's crawl history or its user mappings to see more details. For instructions for viewing an external
content connector's crawl history, see [Review crawl history and analytics for an external content connector](https://servicenow-prod.fluidtopics.net/Dg59nHo5PHtSR0wwfRlccA "View crawl history records and analytics for an external content connector. Drill into a crawl history record to see detailed metrics and errors from the crawl in question."). To learn how to view an external content connector's user mappings, see [Review user mappings for an external content connector](https://servicenow-prod.fluidtopics.net/jhhR46abWrWc72J7l5gq_w "View user and group access permissions retrieved by an external content connector, and see how the connector maps those principals to your ServiceNow AI Platform instance's users.").

*[\>]: and then