--- sourceDocument: Zurich ServiceNow AI Platform Administration sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-administration Release : - zurich ft:locale : - en-US ft:publication_title : - Zurich ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Indexing and searching external content # Indexing and searching external content in AI Search {#ariaid-title1} * Release version: Zurich * * Updated July 31, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Indexing and searching external content in AI Search The External Content for AI Search plugin enables ServiceNow AI Search users to index and search documents and metadata stored outside the ServiceNow AI Platform instance, including sources like SharePoint, Confluence, and remote tables. This capability allows users to retrieve external document content seamlessly alongside native ServiceNow records without duplicating the external documents in the platform. When users select an external search result, they are directed to the original document location. Show full answer Show less ## Key Features * **Search Connector Applications:** Prebuilt connectors available from the ServiceNow Store simplify indexing for supported external sources by automating configuration and schema creation. Examples include connectors for SharePoint Online and multi-source hubs. * **Integration Hub AI Search Spoke:** Provides Workflow Studio actions to ingest external documents, either by defining document properties or downloading via a URL. It offers flexible configuration and drag-and-drop workflow integration. * **External Content REST API:** Offers the most flexible but complex method for indexing by allowing direct submission of document content, metadata, and binary files. Access requires specific roles and supports defining security permissions for indexed documents. ## Prerequisites and Configuration * **Subscription:** An active subscription to the External Content for AI Search plugin is required. * **External Content Schema Table:** Define schema tables mapping external document fields to AI Search index fields. These tables do not store content but define the structure for indexing. For multiple data sources sharing fields and unique identifiers, a single schema table can be used; otherwise, separate tables are needed. Search connector apps create these automatically when applicable. * **Indexed Source Creation:** Create an indexed source specifying the external content schema table to send external document data to the AI Search index. * **Search Source Creation:** Define search sources for subsets of indexed external documents to make their content searchable. ## Security AI Search respects user and group access permissions defined for external documents. You can map external users and groups to ServiceNow AI Platform users to control search result access, ensuring secure handling of external content. ## Expected Outcomes * Enable comprehensive, unified search across internal ServiceNow records and indexed external documents without duplicating external content. * Simplify indexing through connector apps or customize ingestion workflows via Integration Hub or REST API based on source and complexity. * Maintain security and access permissions consistent with external document controls within the AI Search environment. With a subscription for the External Content for AI Search plugin, you can enable AI Search users to search content and metadata from documents in external repositories and remote tables. The External Content for AI Search plugin enables you to index documents located outside of your ServiceNow AI Platform® instance, such as those stored in SharePoint collections, Confluence sites, and [remote tables](https://www.servicenow.com/docs/access?context=remote-tables&version=zurich&pubname=zurich-servicenow-platform&ft:locale=en-US). Indexing these documents makes their content and metadata searchable in AI Search. AI Search displays search results for indexed external documents just as it does for indexed ServiceNow AI Platform records. Users don't need to perform any special searches to match content and metadata from external documents. Indexing doesn't duplicate external documents as records in your ServiceNow AI Platform instance. When a user selects an external document search result, they are directed to the source document in its original location. ## External content indexing tools {#external-content-ais__section_f2n_klx_ksb} The following diagram illustrates how AI Search provides indexing and search for external document content and metadata: Figure 1. AI Search external content architecture diagram As shown in the architecture diagram, you can index content and metadata from external documents using any or all of the following tools: {#external-content-ais__table_cyt_kyw_ksb__entry__2} | External content indexing tool | Description | |-|-| | Search connector applications | Search connector applications available in the ServiceNow Store provide simple tools for indexing content and metadata from documents in supported external sources. They handle some of the configuration work, such as creation of external content schema tables, for you. Each search connector application supports a specific external document source (or set of sources). For example, the [SharePoint Online Search Connector](https://store.servicenow.com/sn_appstore_store.do#!/store/application/32e3b8addb2a5450e7048d7e13961908/) only supports documents in SharePoint collections, while the [Raytion Connector Hub for AI Search](https://store.servicenow.com/sn_appstore_store.do#!/store/application/f7a8af54db9ee01035d0c6cd13961901/) supports multiple document sources. If no search connector application is available for your external document source, you must use the Integration Hub AI Search spoke or the External Content REST API to index content and metadata for documents from that source. Search connector applications provide the most straightforward way to index document content and metadata from supported external sources. | | Integration Hub AI Search spoke | The Integration Hub AI Search spoke provides Workflow Studio actions that you can use to ingest external documents for indexing: * Ingest Document: Define property name-value pairs for an external document and submit the document to AI Search for indexing. * Ingest Document Using Download URL: Specify an external document's URL and have AI Search download it for indexing. {#external-content-ais__ul_xjy_ldx_ksb} You can specify security principal access permissions for documents ingested using these actions. To learn more about access permissions and security for external document content, see [External content security for AI Search](https://www.servicenow.com/docs/wkXNDn8AjlsrtxnQ8jEjaA "AI Search preserves user and group security access permissions specified for documents indexed from external sources. You can control access to external content search results by mapping these externally defined users and groups to ServiceNow AI Platform users."). For the full list of Workflow Studio actions provided by the AI Search spoke, see [AI Search spoke](https://www.servicenow.com/docs/access?context=ai-search-spoke&version=zurich&pubname=zurich-integrate-applications&ft:locale=en-US). The Integration Hub AI Search spoke combines flexible configuration and handling with the simple drag-and-drop Workflow Studio interface. | | External Content REST API | The External Content REST API provides endpoints that you can use to index content and metadata from external documents: * Send external document text content and metadata to AI Search for indexing using the ingestDocuments API endpoint. * Upload external document binary content to AI Search using the storeContent API endpoint. You can associate the stored binary content with a document fed using the ingestDocuments endpoint. {#external-content-ais__ul_cph_nbx_ksb} Note: To access the External Content REST API endpoints, you need either the ais_external_content role or the admin role. You can specify security principal access permissions for documents ingested using the ingestDocuments endpoint. To learn more about access permissions and security for external document content, see [External content security for AI Search](https://www.servicenow.com/docs/wkXNDn8AjlsrtxnQ8jEjaA "AI Search preserves user and group security access permissions specified for documents indexed from external sources. You can control access to external content search results by mapping these externally defined users and groups to ServiceNow AI Platform users."). For full descriptions of the External Content REST API endpoints, see [External Content Ingestion REST API](https://www.servicenow.com/docs/access?context=external-content-ingestion-api&version=zurich&pubname=zurich-api-reference&ft:locale=en-US). The External Content REST API is the most complex tool for indexing content and metadata from your external documents, but it offers the most flexibility. | [ ] {#external-content-ais__table_cyt_kyw_ksb} ## External content search prerequisites {#external-content-ais__section_kh5_ssw_ksb} Before you can index external document content and metadata for search in AI Search, you must satisfy the following requirements. Except as noted in the table, these requirements apply regardless of which external content indexing tools you use. {#external-content-ais__table_eyp_xsw_ksb__entry__2} | Requirement | Description | |-|-| | Have an active subscription for the External Content for AI Search plugin (com.glide.ais.external_content) | The External Content for AI Search plugin provides functionality for indexing content from external data sources. For instructions on purchasing a subscription for the plugin and activating it, see [Request the External Content for AI Search plugin](https://www.servicenow.com/docs/FU6mUZ5zLS~dfVwqFI_gVw "Request activation of the External Content for AI Search plugin (com.glide.ais.external_content) to enable indexing of searchable content and metadata from records in external data sources."). | | Define an external content schema table for the external document source | An external content schema table doesn't store external document content in the database. Instead, its columns serve as a map of AI Search index fields to populate when you index content from external data sources. For instructions on creating a new external content schema table, see [Create an external content schema table](https://www.servicenow.com/docs/FV1X71g8zRmXTPLQ740cmg "Define a schema table with columns corresponding to fields on records from an external data source. AI Search uses the schema when indexing content from the external data source."). When documents from multiple external data sources share the same set of fields and have unique document identifiers, you can use a single external content schema table for all of them. To avoid data loss, the external data sources must satisfy these conditions: * All documents in the external data sources must include the same fields, matching the columns defined in the content schema table. * Every document in the external data sources must have a unique identifier so that documents don't overwrite one another in the AI Search index. {#external-content-ais__ul_f2f_mrw_rnb} If the external data sources can't satisfy these conditions, create a separate external content schema table for each data source. Note: Search connector applications from the ServiceNow Store automatically create external content schema tables as needed. You only need to create your own external content schema tables when indexing external documents using the Integration Hub AI Search spoke or the External Content REST API. | | Create an indexed source with your external content schema table specified as the table to index | The indexed source sends external documents' content and metadata to the AI Search index. For instructions on creating an indexed source, see [Create an indexed source](https://www.servicenow.com/docs/kn3MPRHuFsU5uDmL0JU2Hg "Define an indexed source to make content and metadata from ServiceNow AI Platform table records searchable using AI Search."). | | Create one or more search sources for the indexed source | Each search source specifies a subset of external documents from the indexed source whose content you want to make searchable in AI Search. For instructions on creating search sources, see [Create a search source for AI Search](https://www.servicenow.com/docs/UAnG3ByD5Vc_89ILqBAh_g "Make searchable content from an indexed source available in user search experiences by defining a search source."). | [ ] {#external-content-ais__table_eyp_xsw_ksb} * **[Request the External Content for AI Search plugin](https://www.servicenow.com/docs/FU6mUZ5zLS~dfVwqFI_gVw)** Request activation of the External Content for AI Search plugin (com.glide.ais.external_content) to enable indexing of searchable content and metadata from records in external data sources. * **[Create an external content schema table](https://www.servicenow.com/docs/FV1X71g8zRmXTPLQ740cmg)** Define a schema table with columns corresponding to fields on records from an external data source. AI Search uses the schema when indexing content from the external data source. * **[External content security for AI Search](https://www.servicenow.com/docs/wkXNDn8AjlsrtxnQ8jEjaA)** AI Search preserves user and group security access permissions specified for documents indexed from external sources. You can control access to external content search results by mapping these externally defined users and groups to ServiceNow AI Platform® users. * **[Components installed with External Content for AI Search](https://www.servicenow.com/docs/VI9jYlWTZtXMQ~hSyGPE3A)** When you activate the External Content for AI Search plugin (com.glide.ais.external_content), the system creates a new virtual table.