--- 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 --- # Field settings # Field settings for AI Search {#ariaid-title1} * Release version: Xanadu * * Updated July 28, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 minutes to read A field setting controls indexing behavior for a specified field (column) on all records from an indexed source. Examples of how you might use field settings include the following. * Disable text indexing or searchability for a field found on source table records * Modify default mappings between source table fields and fields in the AI Search index * Add a referenced table field to the index by dot-walking from a reference field on source table records {#field-settings-ais__ul_lb1_xp1_wmb} An indexed source's field settings appear in its Field Settings \& Mapping related list. ## Create a field setting for an AI Search indexed source {#ariaid-title2} Define an indexed source field setting to configure AI Search content indexing behavior for a specific field on source table records. ### Before you begin Role required: ais_admin ### About this task For details on available field settings and values, see [List of AI Search indexed source field settings](https://servicenow-prod.fluidtopics.net/XVYUOPf5kHnLYta4jbie~A#field-settings-list-ais "You can adjust indexing behavior for source record fields in an AI Search indexed source by configuring field setting attributes and values."). ### Procedure 1. Navigate to AllAI SearchAI Search IndexIndexed Sources. 2. Open the indexed source that you want to define a field setting for. 3. In the Field Settings \& Mapping related list, select New. 4. On [the Field Setting form](https://servicenow-prod.fluidtopics.net/uYHFB4EKH9svmdk47neGOw "The Field Setting form contains information about field-specific settings defined for your AI Search indexed sources. Use this form when creating or modifying a field setting for an indexed source."), fill in the fields. 5. Select Submit. {#create-field-setting-ais__steps_l4v_wfb_gnb} ### Result The new field setting appears in the Field Settings \& Mapping related list. ### What to do next To make the new field setting take effect, perform a full table reindex for the indexed source. For details on this procedure, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). ## Enable indexing of referenced table fields for an AI Search indexed source {#ariaid-title3} Configure an indexed source to index field values from tables referenced by fields in the source table. You can index these field values for use in filters and EVAM search result configurations, index them for search, or both. ### Before you begin You must have an indexed source configured for the source table. For details on creating an indexed source for a table, see [Create an indexed source](https://servicenow-prod.fluidtopics.net/U_c5gIJZKoRh7H~bGkRyaA "Define an indexed source to make content and metadata from ServiceNow AI Platform table records searchable using AI Search."). Role required: ais_admin ### About this task When an indexed source table includes a reference field, AI Search defaults to indexing values for the reference field but not for other fields on the table that it references. To index values from these referenced table fields, you can create dot_walk_fields and searchable_dot_walk_fields field settings on your indexed source table. * To use field values from referenced tables in search source filters, facet filters, and EVAM search result configurations, create a dot_walk_fields field setting. * To make field values from referenced tables searchable, create a searchable_dot_walk_fields field setting. {#enable-ref-table-field-index-ais__ul_cb4_xs4_v5b} As the value for either of these field settings, list the names of the referenced table fields you want to index, separated by commas. For example, to index the name and city fields from the table referenced by the company field on the indexed source table, select the company field and enter value name,city. To dot-walk across multiple tables, you can enter field name values with dot-separated reference field prefixes. For example, enter value company.contact.name to index the name field in the table referenced by the contact field on the table referenced by the indexed source table's company reference field. Note: Each dot-walk reference level imposes a performance impact on indexing. Avoid using multi-level references unless necessary. You can create both dot_walk_fields and searchable_dot_walk_fields field settings for the same reference field. ### Procedure 1. Navigate to AllAI SearchAI Search IndexIndexed Sources. 2. In the Field Settings \& Mapping related list, select New. 3. On [the Field Setting form](https://servicenow-prod.fluidtopics.net/uYHFB4EKH9svmdk47neGOw "The Field Setting form contains information about field-specific settings defined for your AI Search indexed sources. Use this form when creating or modifying a field setting for an indexed source."), enter the field values shown for your use-case. * To index field values from referenced tables for use in search source filters, facet filters, and EVAM search result configurations, enter the following field values.{#enable-ref-table-field-index-ais__table_o35_w2l_55b__entry__2} | Field | Value | |-|-| | Attribute | dot_walk_fields | | Field | \ | | Value | \ | [ ] {#enable-ref-table-field-index-ais__table_o35_w2l_55b} * To index field values from referenced tables as searchable text, enter the following field values.{#enable-ref-table-field-index-ais__table_zw5_w2l_55b__entry__2} | Field | Value | |-|-| | Attribute | searchable_dot_walk_fields | | Field | \ | | Value | \ | [ ] {#enable-ref-table-field-index-ais__table_zw5_w2l_55b} {#enable-ref-table-field-index-ais__choices_ofn_r2l_55b} Note: If the dot_walk_fields and searchable_dot_walk_fields attributes don't appear in the Attribute selection list, ensure that your Field selection is a reference field. 4. Select Submit. The attribute and value appear in the Field Settings \& Mapping related list. ## List of AI Search indexed source field settings {#ariaid-title4} You can adjust indexing behavior for source record fields in an AI Search indexed source by configuring field setting attributes and values. For more information on creating field settings, see [Create a field setting for an AI Search indexed source](https://servicenow-prod.fluidtopics.net/XVYUOPf5kHnLYta4jbie~A#create-field-setting-ais "Define an indexed source field setting to configure AI Search content indexing behavior for a specific field on source table records."). {#field-settings-list-ais__table_m5b_r3j_smb__entry__2} | Attribute | Description | |-|-| | dot_walk_fields | Index reference and display values from fields on the selected reference field's source table for use in search source filters, facet filters, and EVAM search result configurations. AI Search automatically updates the indexed field values to reflect changes made to the referenced table's field values. For more information about search source filters, see [Search sources in AI Search](https://servicenow-prod.fluidtopics.net/rRLONKzjnEhenBae4lDmeg "Define search sources to make your searchable content available in search experiences. Choose an indexed source and configure optional filter conditions to limit the content that users can search."). For details on facet filters, see [Create a facet in an AI Search application configuration](https://servicenow-prod.fluidtopics.net/DSngZomT7eAdJi9jDRHeCA "Define facets to refine your searches using categories dynamically generated from the current search results."). * Field: Name of the reference field on your indexed source table. As an example, if your indexed source table contains a company reference field that references the Company \[core_company\] table, and you want to index field values from that table's name and city fields, you'd set company as the field. * Type: string * Value: Comma-separated list of referenced table fields to index values from. As an example, if your indexed source table contains a company reference field that references the Company \[core_company\] table, and you want to index field values from that table's name and city fields, you'd set name,city as the value. {#field-settings-list-ais__ul_nw2_sfp_5mb} Note: You can't search field values indexed with this field setting. To index field values from referenced tables for search, create a searchable_dot_walk_fields field setting. You can create both dot_walk_fields and searchable_dot_walk_fields field settings for the same reference field. If you change the value of this setting for an indexed source's field, the change doesn't take effect until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). | | index_calculated_field | Option to enable indexing of searchable content from calculated field values. If your indexed source contains a calculated field, set this field setting to true for that field to correctly index its values. With a field setting value of false or no value, AI Search ignores values from the calculated field when indexing content. * Field: Name of a calculated field from the indexed source table. (If you specify a non-calculated field, the system rejects the field setting submission and displays a warning message.) * Type: true \| false * Supported values: * true: Apply special handling to correctly index calculated field values from the selected field. * false: Don't apply special handling when indexing field values from the selected field. Calculated field values aren't indexed. {#field-settings-list-ais__ul_ghr_xvt_5xb} {#field-settings-list-ais__ul_pcg_wvt_5xb} If you change the value of this setting for an indexed source's field, the change doesn't take effect until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). | | map_to | Map the selected field from the indexed source table to an AI Search index field. When indexing records from the source table, AI Search populates the specified index field with the value of the selected source field. For example, the base system's Knowledge Table indexed source maps the kb_knowledge.short_description source field to the title index field. When AI Search indexes a record from the Knowledge \[kb_knowledge\] table, it populates the indexed record's searchable title with the value from the source record's short_description field. * Field: Name of a field from the indexed source table. * Type: string * Value: Name of the AI Search field that you want to map the selected field's display values to. For details on AI Search index fields, see [AI Search index fields](https://servicenow-prod.fluidtopics.net/dE90TfJvpMHpTzzbG3S~Ng "List of fields available on records in the AI Search index. AI Search populates these fields with values from source record fields during indexing."). {#field-settings-list-ais__ul_znt_lfp_5mb} Note: You can only define one map_to field setting for an indexed source field. If you try to define multiple map_to settings for the same field, the system displays an error message. If you change the value of this setting for an indexed source's field, the change doesn't take effect until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). | | no_text_index | Option to disable indexing of searchable content from the selected field on records from the indexed source. * Field: Name of a field from the indexed source table. * Type: true \| false * Supported values: * true: Disable searchable content indexing for the selected field. Search and filters can't match the field's value. AI Search doesn't generate an index event when the field is updated. * false: Enable searchable content indexing for the selected field. Search and filters can match the field's value. AI Search generates an index event when the field is updated, adding the affected record to its indexing queue. {#field-settings-list-ais__ul_tt1_22k_smb} * Default value: false {#field-settings-list-ais__ul_ub5_d34_v5b} If you change the value of this setting for an indexed source's field, the new value immediately affects index event generation for updates to that field, but it doesn't affect searches or filters for previously indexed records until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). Warning: Don't set this option to true for the sys_updated_on field on the Task \[task\] table, tables that extend Task, or any other tables that you've configured retention policies for. The retention policies for these tables rely on indexing of sys_updated_on field values. For more information on retention policies, see [Indexed source retention policies and filter conditions](https://servicenow-prod.fluidtopics.net/kz7xohoQDkrV_ebnvqq11w "AI Search uses settings to automatically purge stale records from the index and optimize search performance. To limit the set of records indexed from source tables, you can configure retention policies and filter conditions for your indexed sources."). For Customer Service and Support guidelines on setting the no_text_index option for different field types, see [KB0859922](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0859922) on the Now Support site. | | not_searchable | Option to disable search matching for content indexed from the selected field. * Field: Name of a field from the indexed source table. * Type: true \| false * Supported values: * true: Disable search matching for content indexed from the selected field. Search can't match the field's value. Filters (such as for content security, navigation tabs, and facets) can still match the field's value. * false: Enable search matching for content indexed from the selected field. Search and filters can match the field's value. {#field-settings-list-ais__ul_d5t_rl5_vnb} * Default value: false {#field-settings-list-ais__ul_dkl_134_v5b} If you change the value of this setting for an indexed source's field, the change doesn't take effect until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). | | searchable_dot_walk_fields | Index reference and display values from fields on the selected reference field's source table as searchable text. AI Search doesn't automatically update the indexed field values to reflect changes made to the referenced table's field values. To update the indexed field values, you must reindex the indexed source. For details on this procedure, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). * Field: Name of the reference field on your indexed source table. As an example, if your indexed source table contains a company reference field that references the Company \[core_company\] table, and you want to index searchable text from that table's name and city fields, you'd set company as the field. * Type: string * Value: Comma-separated list of referenced table fields to index as searchable content. As an example, if your indexed source table contains a company reference field that references the Company \[core_company\] table, and you want to index searchable text from that table's name and city fields, you'd set name,city as the value. {#field-settings-list-ais__ul_e2q_ycl_55b} Note: You can't use field values indexed with this field setting in search source filters. To index field values from referenced tables for use in search source filters, create a dot_walk_fields field setting. You can create both dot_walk_fields and searchable_dot_walk_fields field settings for the same reference field. If you change the value of this setting for an indexed source's field, the change doesn't take effect until you reindex content from the indexed source. For reindexing steps, see [Perform a full table index or reindex for a single AI Search indexed source](https://servicenow-prod.fluidtopics.net/ylmJp1OFiNmWvOFFxmjvuw "Make content from an internal indexed source searchable by performing a full table index. This procedure indexes existing records from the source table and any child tables configured for indexing. You can manually reindex content from an internal indexed source by repeating this procedure."). | [ ] {#field-settings-list-ais__table_m5b_r3j_smb} Note: Field settings are records on the AI Search Configuration Attribute \[ais_configuration_attribute\] table that have Column as their Applies To field value. Records on this table that have Table as their Applies To field value are [Indexed source attributes for AI Search](https://servicenow-prod.fluidtopics.net/mzacd2zfN8fz4i3I_HiyFw#indexed-source-attributes-ais "An indexed source attribute defines indexing behavior for all records from an indexed source."). This example shows how the base system's Catalog Item Table indexed source maps short_description field values from the Catalog Item \[sc_cat_item\] table to the AI Search index's text field for indexed records.
## Security for searchable referenced table field values in AI Search {#ariaid-title5} When a user searches referenced table field values that you have indexed for search with the searchable_dot_walk_fields field setting, only field values that the user can view appear in the search results. The system uses a field value's role-based access control list rules (ACLs) to determine whether the search user can view that field value. Searchable referenced table field values that have condition-based or script-based ACLs or user criteria don't appear in search results. For searchable field values indexed through multiple dot-walk reference levels, the system only considers role-based ACLs on the final field value. As an example, if you index company.contact.name referenced table field values for search, user access to name field values isn't affected by role-based ACLs on contact field values. To bypass all ACLs and allow users to search for all searchable referenced table field values, you can set the glide.ais.query.allow_indexlookup_for_dotwalk system property to true. This bypasses ACL evaluation for field values indexed via the dot_walk_fields and searchable_dot_walk_fields field settings. For more details on ACL types and configuration, see [Access control list rules](https://www.servicenow.com/docs/access?context=access-control-rules&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). *[\>]: and then