--- 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 --- # Synonyms # Synonyms {#ariaid-title1} * Release version: Xanadu * * Updated July 16, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes to read Synonyms expand search queries to include additional terms with equivalent meaning or usage. Improve search recall by configuring synonym dictionaries and defining synonyms. To define synonyms, modify the default synonym dictionary for a search profile or create a new synonym dictionary linked to one or more search profiles. Create and publish synonyms for each dictionary. Publish the dictionary to make your synonyms take effect for searches that use linked search profiles. You can delete synonym dictionaries that aren't linked to any search profiles. ## Synonym usage in search {#synonyms-ais__section_hnh_4wz_qmb} When a search query includes a term defined in a synonym, AI Search expands the search to include all equivalent terms defined in the synonym. For example, a synonym might expand the search query term vacation to vacation OR holiday OR pto. The expanded query returns records that contain any of the three equivalent terms. ## Conditions for synonym eligibility {#synonyms-ais__section_ljy_n4x_3nb} To be eligible for expanding a search query's terms, a synonym must satisfy the following conditions: * It must be active. * The synonym dictionary that includes it must be published. * Its length doesn't exceed the [dictionary term-length limit](https://servicenow-prod.fluidtopics.net/cjrGZ8bePEfjKrApMpyYnQ#synonyms-ais__dictionary-term-length-limit-synonyms). {#synonyms-ais__ul_emp_tft_qtb} The system locates eligible synonyms in synonym dictionaries as follows:{#synonyms-ais__table_swg_bft_qtb__entry__2} | Condition | Result | |-|-| | The search profile specified for the search query links to a published synonym dictionary for the search query's language. | The system only considers synonyms from the linked synonym dictionary. As an example, suppose a search application's search profile links to a French synonym dictionary. When a user searches in French in this application, only synonyms from the linked French synonym dictionary are eligible to expand search query terms. | | The search profile specified for the search query doesn't link to a published synonym dictionary for the search query's language. | The system only considers synonyms from the default (English) synonym dictionary. As an example, suppose a search application's search profile has no linked Spanish synonym dictionary. When a user searches in Spanish in this application, only synonyms from the default (English) synonym dictionary are eligible to expand search query terms. | [ ] {#synonyms-ais__table_swg_bft_qtb} For more details on language support in synonym dictionaries, see [Language dependence](https://servicenow-prod.fluidtopics.net/cjrGZ8bePEfjKrApMpyYnQ#synonyms-ais__synonym-language-dependence-section). ## Synonym terms and payloads {#synonyms-ais__section_zrb_j2r_smb} Each synonym includes two or more equivalent terms, defined in two fields. The Term field contains one term designated as the synonym's label. The Payload field contains the remaining equivalent terms, formatted as a JSON array. Synonym term expansion is bidirectional. AI Search treats all terms defined in the Term and Payload fields as equivalent, as illustrated in the following table. {#synonyms-ais__table_w3r_wkx_3nb__entry__2} | Use case | Synonym expansion behavior | |-|-| | Search query term matches the term from a synonym's Term field | AI Search expands the search query term to match all equivalent terms from the Payload field. | | Search query term matches a term from the Payload field | AI Search expands the search query term to match the term from the Term field and all remaining equivalent terms from the Payload field. | [ ] {#synonyms-ais__table_w3r_wkx_3nb} ## Dictionary term-length limit {#synonyms-ais__dictionary-term-length-limit-synonyms} By default, AI Search ignores synonym terms that exceed 256 characters in length. You can override this default limit by adding the query.maxDictionaryTermLength system property. The integer value of this system property indicates the maximum allowable character length for stop word and synonym dictionary terms. For information on adding a system property, see [Add a system property](https://servicenow-prod.fluidtopics.net/r_0P5ICBCd42vTv64UVY9w#t_AddAPropertyUsingSysPropsList "Add or create a property to control system behavior."). Warning: Exercise caution when increasing the dictionary term-length limit beyond its default value. Processing long dictionary terms increases AI Search's memory usage, and in some cases search queries may fail with out-of-memory errors. ## Multi-word phrases {#synonyms-ais__section_ukq_yzf_rmb} A synonym term can include either a single word or a multi-word phrase. AI Search expands multi-word phrases when the search query terms exactly match the order and proximity of the phrased words in the synonym definition. If a user searches with these words in a different arrangement, no expansion occurs. For example, the following table describes AI Search expansion behavior for a synonym that includes the single word 401k and the multi-word phrase retirement account. {#synonyms-ais__table_fv4_wzf_rmb__entry__2} | Search query terms | Synonym expansion behavior | |-|-| | 401k | AI Search expands the search query to match either 401k or retirement account. | | retirement account | AI Search expands the search query to match either 401k or retirement account. | | retirement account bank | AI Search expands the search query to match either 401k or retirement account in addition to bank. | | account retirement | AI Search doesn't expand the search query terms. | | retirement bank account | AI Search doesn't expand the search query terms. | [ ] {#synonyms-ais__table_fv4_wzf_rmb} When search query terms match a multi-term synonym, AI Search treats those terms as a quoted phrase. For example, if you define 401k and retirement account as synonyms and a user searches for the unquoted terms retirement account, AI Search returns results that match the quoted phrase "retirement account". ## Case sensitivity {#synonyms-ais__section_rdw_3bg_rmb} By default, synonym expansion ignores letter case when comparing synonyms with search query terms. You can enable case sensitivity for a synonym dictionary. This option affects all synonyms defined in the dictionary. When case sensitivity is enabled, synonyms in the dictionary only match search query terms or phrases that include the same combination of uppercase and lowercase letters. For example, if you define a synonym including the word CASE and the phrase Computer-Aided Software Engineering, AI Search expands searches for CASE but not searches for case. ## Punctuation sensitivity {#synonyms-ais__section_tgh_jbg_rmb} By default, synonym expansion ignores punctuation when comparing synonyms with search query terms. You can enable punctuation sensitivity for a synonym dictionary. This option affects all synonyms defined in the dictionary. When punctuation sensitivity is enabled, synonyms in the dictionary only match search query terms or phrases that include the same punctuation. For example, suppose you define a synonym equating U-S-A with University of South Australia and another synonym equating U.S.A. with United States of America. Without punctuation sensitivity enabled, a search for U.S.A. expands to match both University of South Australia and United States of America. When punctuation sensitivity is enabled, the same search only expands to match United States of America. ## Language dependence {#synonyms-ais__synonym-language-dependence-section} Synonym expansion is language-dependent. You specify a language for each synonym dictionary, and this language applies to all synonyms defined in the dictionary. Synonyms from dictionaries with the same language as the search query are eligible for expansion. Note: If the search profile specified for a search query has no linked synonym dictionary for the search query language, AI Search uses the default (English) synonym dictionary as a fallback. AI Search supports synonym dictionaries for all languages activated in your instance. For the list of languages you can activate, see [Activate a language](https://servicenow-prod.fluidtopics.net/JVX9OJGGemU7rGe1QNjBRw "By default, the language supported by the platform is American English. You can activate plugins for other supported languages if you have the admin role."). ## Interaction with other search features {#synonyms-ais__section_p3f_wsy_2nb} The following table describes interactions between synonyms and other search features. {#synonyms-ais__table_vdr_yd5_fnb__entry__2} | Feature | Interaction with synonyms | |-|-| | [Genius Results](https://servicenow-prod.fluidtopics.net/tifPTb4QLvFRp1Vwd2sMcQ "Optionally display the best answers for a search query as actionable Genius Result cards included with search results.") | Synonym expansion terms can't trigger Genius Result configurations with Term trigger conditions. When computing Q\&A Genius Results for a search query, AI Search expands synonyms in the query. | | [Lemma and Unicode normalization](https://servicenow-prod.fluidtopics.net/dtWWHHYDmYUsOuASp_0jvg "AI Search normalizes inflected words and Unicode glyphs during indexing and at search query time. Normalization improves search recall and enables users to find content with variant forms of their search query terms.") | If a search query term is defined as a synonym, AI Search doesn't normalize it. | | [Result improvement rules](https://servicenow-prod.fluidtopics.net/J~mLT_HXtldLRqaNKcQgSw "Define rules with configurable trigger conditions to boost, block, or promote search results for specific searches. You can also boost search results for documents matching elements of the user context, such as a user's country, OS, or device type.") | By default, a synonym expansion term can activate a result improvement rule if it matches the rule's Query trigger. You can prevent synonym expansion terms from activating a rule with a Query trigger by clearing the Expand Synonyms For Query Conditions option that appears when you define the Query trigger. Note: Starting in the Xanadu release, AI Search uses synonyms to expand user context field values when applying boost actions from result improvement rules. As an example, if the user context location is Paris and you define a synonym that defines Paris and France as equivalent, your result improvement rule boosts documents containing France as well as those containing Paris. For more details on boost actions, see [Boost search results using a result improvement rule](https://servicenow-prod.fluidtopics.net/xs8NxrwynsO6luNMgHxqeA#boost-results-ais "Increase the relevancy scores for search results that satisfy a custom set of conditions."). | | [Stop words](https://servicenow-prod.fluidtopics.net/Cim4Rf8qhGT64T_dt2XUZA "Stop words remove search query terms that don't produce meaningful results. Improve search precision and relevancy by configuring stop word dictionaries and defining stop words.") | If a synonym definition includes a term defined as a stop word, AI Search retains that term when checking whether the synonym expands a search query. For example, suppose you define as and a as stop words and SAAS↔︎software as a service as a synonym. * If you search for saas, AI Search retains the as and a terms in the synonym expansion. As a result, the search query matches the following records: * records that contain the original search query term saas * records that contain the synonym expansion phrase software as a service {#synonyms-ais__ul_tsr_5rq_tzb} * If you search for software as a service, AI Search retains the as and a query terms when checking for synonym expansions. As a result, the search query matches the following records: * records that contain the phrase software as a service * records that contain the synonym expansion term saas {#synonyms-ais__ul_lxn_xrq_tzb} {#synonyms-ais__ul_ivs_1rq_tzb} | | [Typo handling](https://servicenow-prod.fluidtopics.net/pmfC8lQxxBx7TjVN98~VRA "AI Search replaces misspelled search query terms with auto-correction terms derived from indexed content. Configure typo handling dictionary settings to control derivation of auto-correction terms.") | If a misspelled search query term is defined as a synonym, AI Search expands that synonym without auto-correcting it. | [ ] {#synonyms-ais__table_vdr_yd5_fnb} ## Publishing synonym dictionaries {#synonyms-ais__section_sq5_zf5_hnb} Publishing a synonym dictionary makes its settings and active synonyms take effect in all linked search profiles. Publishing a search profile updates the profile's synonym dictionary links but doesn't update the dictionary's settings or active synonyms in AI Search. * **[Create a synonym dictionary linked to a search profile](https://servicenow-prod.fluidtopics.net/kN2kJ8_nxK7jdEYkIGLH8g)** Define a new synonym dictionary and link it to a search profile. * **[Create synonyms](https://servicenow-prod.fluidtopics.net/910Up0Vt8Z2J7ONaBQ_ysQ)** Define terms to treat as equivalent in search queries. * **[Clone a synonym dictionary](https://servicenow-prod.fluidtopics.net/oCkogvfyWwzdAvXmCTsz6w)** Create a copy of an existing synonym dictionary. * **[Link a synonym dictionary to a search profile](https://servicenow-prod.fluidtopics.net/lj8cQf57tKyt1rCWWTdNPA)** Link an existing synonym dictionary to one or more search profiles. * **[Unlink a synonym dictionary from a search profile](https://servicenow-prod.fluidtopics.net/g5Qlt4F8TLYa5dnWugJnSQ)** Remove a synonym dictionary from a search profile. * **[Delete a synonym dictionary](https://servicenow-prod.fluidtopics.net/TSLYzzjtwWnP500R0yjfsQ)** Remove a synonym dictionary that isn't linked from any search profile.