# Synonyms

### How to Create a Synonym List for Keyword Taxonomy

Enhancing the search-ability of your Knowledge Base can be achieved by creating a Synonym List for your Keyword Taxonomy. Here's how:

#### Important Note:

While this process enhances search functionality by creating a web of related terms, remember that **deletions are irreversible**. If a synonym is mistakenly deleted, it must be manually re-added following the steps outlined.

By integrating synonyms into your Keyword Taxonomy, you significantly improve the search effectiveness within your Knowledge Base, making information retrieval more intuitive and user-friendly.

### Adding a Synonym

{% hint style="info" %}

### Before you start

You must have Text Retrieval Setup selected in your own General Access security role before you can create synonyms.
{% endhint %}

1. Select the Menu button, then **Admin**, and then select **System Administration**. The System Administration window is displayed.
2. Expand the **Text Retrieval** group, scrolling down if necessary.
3. From within the **Text Retrieval** group, select **Synonyms**. A browse table appears, with all of the keywords on the system with synonyms.
4. Select the **New** icon. The **Select Keyword** dialog box appears with a list of all the keywords that have been defined for your system.
5. At **Keyword**, select the keyword for which you want to define a synonym. The entry is highlighted.
6. Select **Ok**. The dialog box closes and the selected keywords are added to the **Keyword** list on the **Synonyms** window. Key the synonym for the keywords in the **Synonym** list. (You may like to adjust the column widths to see all of the columns.)
7. Repeat to add more synonyms. You can select the same keyword again if you wish to have several synonyms for the same keyword.
8. Select to save the changes. Provide the Change Reasons if prompted to do so.&#x20;
9. The list is redisplayed, with your new synonyms listed in uppercase.

### Deleting a Synonym

{% hint style="warning" %}
You cannot reverse this procedure. If you deleted a word by mistake, you have to re-create the entry by adding the word to the list.
{% endhint %}

1. Select the Menu button, then **Admin**, and then select **System Administration**. The System Administration window is displayed.
2. Expand the **Text Retrieval** group, scrolling down if necessary.
3. From within the **Text Retrieval** group, select **Synonyms**. A browse table appears, with all of the keywords on the system with synonyms.
4. Select the synonym you want to delete and then select the **Delete** icon.
5. The entry disappears, but the changes are not permanent until you save the changes.
6. Repeat for each synonym you want to delete.
7. Select to save the changes. Provide the Change Reasons if prompted to do so.&#x20;
8. The list is redisplayed and the changes are permanent.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.alemba.com/asm/asm-hermes/setup-and-configure-asm/configuring-your-system/system-administration-settings/text-retrieval/synonyms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
