---
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


---

# Create synonym dictionaries

# Create synonym dictionaries {#ariaid-title1}

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

You can create synonym dictionaries to expand Zing text searches with additional search keywords.

## Before you begin

Role required: ts_admin or admin

## About this task

By default, the system provides a sample Zing synonym dictionary called Example synonym dictionary. You can add synonyms to this dictionary or create your own synonym dictionaries.

## Procedure

1. Navigate to AllSystem DefinitionText Index Synonym Dictionaries.
2. Select New.
3. On the Synonym Dictionary form, fill in the fields.  
   {#create-synonym-dictionaries__table_bf4_dkb_fx__entry__2}

   | Field | Description |
   |-|-|
   | Name | Unique name for the synonym dictionary. |
   | Active | Option to make the synonym dictionary active. Zing only uses active synonym dictionaries when expanding searches. |
   | Global | Option to use the synonym dictionary for searches against all tables that have not been individually configured. |
   | State | Publication state for the synonym dictionary. This field is read-only. |
   | Order | Order of evaluation for the synonym dictionary. Zing evaluates synonym dictionaries with lower Order values before dictionaries with higher values. |
   | Description | Description of the synonym dictionary. |
   [Table 1. Synonym Dictionary form]

   {#create-synonym-dictionaries__table_bf4_dkb_fx}
4. For each set of synonyms you want to add to the synonym dictionary, insert a new Synonym Set row and fill in the fields.  
   {#create-synonym-dictionaries__table_rp2_jzb_fx__entry__2}

   | Field | Description |
   |-|-|
   | Synset | Comma-separated set of synonym expansions. Zing expands searches containing any one of these terms to include all of these terms. As an example, if you define the synonym set <kbd class="ph userinput">medicalise,médicalisé</kbd> and search for <kbd class="ph userinput">medicalise</kbd>, Zing expands your search to match records containing either medicalise or médicalisé. |
   | Active | Option to make this synonym set active. Zing only uses active synonym sets when expanding searches. |
   | Description | Description of the synonym set. |
   [Table 2. Synonym set fields]

   {#create-synonym-dictionaries__table_rp2_jzb_fx}
5. Select Submit.
6. Select the Publish All Dictionaries related link.  
   A message indicates that publication of your synonym dictionaries has been scheduled. Refresh the page to see whether publication is complete. The dictionary is published when its state changes from Draft to Published.
**Related tasks**   

* [Enable search synonyms](https://servicenow-prod.fluidtopics.net/e9_svviH0Jxfs~Br3PsgwA "Enabling text index synonyms allows Zing to expand text searches with additional search keywords.")
* [Select synonym dictionaries for a table](https://servicenow-prod.fluidtopics.net/AswtsRNpEKfhDl61zBnLiw "Search administrators can specify one or more synonym dictionaries available to a particular table.")
* [Disable synonyms for a table](https://servicenow-prod.fluidtopics.net/6R3DE~6AJeVgO9U1pSlX6Q "By default, Zing uses all active synonym dictionaries when a user performs a text search. Search administrators can disable synonym dictionary usage on a per-table basis.")
* [Debug synonym searches](https://servicenow-prod.fluidtopics.net/Hb0hADbgqMfp6QaeCSZAGw "You can view debug messages to determine if synonym searches are working as expected.")

*[\>]: and then