--- sourceDocument: Brazil ServiceNow AI Platform Administration sourceDocumentLink: https://www.servicenow.com/docs/r/platform-administration Release : - brazil ft:locale : - en-US ft:publication_title : - Brazil ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Synonyms # Synonyms {#ariaid-title1} Release version: Brazil Updated September 10, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 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 Synonyms Synonyms in AI Search enable expanding search queries to include additional terms with equivalent meanings, improving search recall. By configuring synonym dictionaries and defining synonyms, you can customize how search queries are expanded to return more comprehensive results. Show full answer Show less ## Key Features * **Synonym Dictionaries:** Modify default dictionaries or create new ones linked to search profiles. Dictionaries must be published to activate synonyms for linked search profiles. * **Synonym Definition:** Each synonym includes a Term (label) and Payload (equivalent terms in JSON array). Expansion is bidirectional, treating all terms as equivalent. * **Eligibility and Language Dependence:** Only active synonyms in published dictionaries linked to the search profile's query language expand queries. If no dictionary matches the query language, the default English dictionary is used. * **Term Length Limit:** Default maximum term length is 256 characters; this can be increased via a system property but may impact memory usage and query performance. * **Multi-word Phrases:** Synonyms can include phrases, expanded only when query terms match exact order and proximity. * **Case and Punctuation Sensitivity:** Options to enable case-sensitive and punctuation-sensitive matching at the dictionary level. * **Interaction with Other Features:** Synonym expansion integrates with result improvement rules, handles stop words, and affects typo handling by expanding synonyms without auto-correction. ## Practical Application for ServiceNow Customers By defining and publishing synonym dictionaries, ServiceNow customers can significantly enhance AI Search results, ensuring users find relevant records even when different terminology is used. Linking dictionaries to language-specific search profiles allows precise control over query expansion based on language. Careful management of term length limits and sensitivity settings helps optimize search performance and relevance. ## Managing Synonym Dictionaries * **Create and Link:** Create synonym dictionaries and link them to search profiles to enable synonym expansion for those profiles. * **Publish:** Publish dictionaries to activate synonyms in linked profiles; publishing search profiles alone does not update synonym settings. * **Clone and Delete:** Clone existing dictionaries for easier management or delete dictionaries not linked to any profiles. * **Unlink:** Remove dictionaries from specific search profiles when no longer needed. 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://www.servicenow.com/docs/Hi1R~ppcP6sC6ADHMFNQXg#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://www.servicenow.com/docs/Hi1R~ppcP6sC6ADHMFNQXg#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://www.servicenow.com/docs/r8VOwqriw1Da0n_tLFFuFw "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://www.servicenow.com/docs/4LuVYMAK0tE6YOrBMx0nvw "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://www.servicenow.com/docs/CJK~c2uMKCE1h69Emtcyhw "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://www.servicenow.com/docs/LOW9Xpl0UfLGcvCmVtwG6Q "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://www.servicenow.com/docs/AxCz3_kbj9LAGMswbLxFKw "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 with 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://www.servicenow.com/docs/Tsd2OqY_jwjxF4guFCDVZQ#boost-results-ais "Increase the relevancy scores for search results that satisfy a custom set of conditions."). | | [Stop words](https://www.servicenow.com/docs/EmWPPGCynK2PjF75HM82dg "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://www.servicenow.com/docs/bN1P~SHrD_KVicEigvXZWQ "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://www.servicenow.com/docs/Wi_fq0eZLYNuSEy3g_~N6w)** Define a new synonym dictionary and link it to a search profile. * **[Create synonyms](https://www.servicenow.com/docs/T9OTgXjXD9SW6N85Xx~A_A)** Define terms to treat as equivalent in search queries. * **[Clone a synonym dictionary](https://www.servicenow.com/docs/cFz3laQWsuv_EhHsQxDrnA)** Create a copy of an existing synonym dictionary. * **[Link a synonym dictionary to a search profile](https://www.servicenow.com/docs/MrbH~xjAhf_LqAUFgnlRzA)** Link an existing synonym dictionary to one or more search profiles. * **[Unlink a synonym dictionary from a search profile](https://www.servicenow.com/docs/19XBkU61~4X4MiL~oaxvwA)** Remove a synonym dictionary from a search profile. * **[Delete a synonym dictionary](https://www.servicenow.com/docs/xxHvTldBJIt5W_rSmBAL9Q)** Remove a synonym dictionary that isn't linked from any search profile.