Synonyms
Add and edit synonym records that link customers' incorrect or alternative spellings to the canonical word.
Synonyms screen is where you match incorrect or alternative spellings that customers may type into the search box with a single Canonical word. For example, when you link the spellings "tshirt" and "t shirt" to the word "t-shirt", searches using these spellings will search for the canonical word instead of the synonyms. The catalog and e-commerce team responsible for search quality adds new mappings and updates existing ones on this screen.
Accessing the screen
Follow the menu path Searchandising › Rules › Synonyms.
If you do not see it in the menu, your account does not have permission for this screen. If you can see the list but the New synonym button and the edit pencil icons on rows are not visible, your account has view-only permission on this screen.
Screen sections
- Title — The Synonyms title and on the right (if you have write permission) the New synonym button.
- Summary cards — Total synonyms and Distinct sites.
- Filter area — Search word and Site id fields; Clear and Filter buttons.
- List — Per page selection, "Filter result: … records" count, refresh button, Columns menu, table and pagination.
- Note — Below the list, the note "There is no deletion in this list: records are only added and updated."
Summary cards
| Card | Meaning |
|---|---|
| Total synonyms | Number of records matching the applied filters (not only on this page but all pages). When no filter is applied, it is the count of all defined mappings. |
| Distinct sites | Number of different site IDs appearing in the records. Selecting a filter in Site id does not change this number. |
Filtering and searching
Entries in the filter fields are applied by pressing the Filter button or Enter while in the field; the list reloads from the first page. If there are unapplied changes, the Filter button appears highlighted.
| Field | Purpose | Tip |
|---|---|---|
| Search word | Performs a text search within records. | Try typing part of the canonical word or one of the synonyms. |
| Site id | Narrows the list to records belonging to a single site. | If records have sites, the field appears as a dropdown list; selecting All removes the filter. If no records have sites or the list is not yet loaded, the field is a text box. |
Clear empties all filters and immediately reloads the list. Filters and sorting are stored in the page URL; you can share a filtered list link.
List
| Column | Meaning |
|---|---|
| Canonical word | The word searched instead of the synonyms. This column cannot be hidden. |
| Synonym words | Spellings linked to the canonical word, shown as blue tags. Up to 8 tags are shown; more are indicated with a count like "+3". Hovering with the mouse shows the full list. |
| Site id | The site to which the record belongs. Since the record window selects from a company list, the company name appears here. If empty, "—" is shown. |
- Sorting: All three columns are sortable; click the header. Changing sorting returns to the first page.
- Page size: 25, 50, or 100. Default is 25.
- Hide columns: You can hide Synonym words and Site id columns from the Columns menu. The choice is remembered in this browser.
- Refresh: The refresh button on the top bar reloads the list without changing filters.
- Clicking a row does not open a page; editing is done via the pencil icon on the right of the row.
Actions
Adding a new synonym
Use when you notice customers write a product or brand in different ways (e.g., spellings with no search results in search logs).
- Click the New synonym button at the top right.
- Enter alternative spellings separated by commas in the Synonym words field (e.g.,
tshirt, t shirt, tişört). - Enter the word to be searched instead of these spellings in the Canonical word field (e.g.,
t-shirt). - If needed, select the company from the Site (company) list.
- Click Save (or press Enter in a text field).
If successful, a "Saved" notification appears, the window closes, and the list and cards refresh. No confirmation is asked before saving.
Editing a record
- Click the pencil icon (Edit) on the right of the row.
- The window opens titled "Edit synonym: <word>" with the current values. Synonyms appear as a single comma-separated line.
- Add or remove spellings, change the canonical word or site if needed.
- Click Save.
The record updates immediately and the list refreshes. Cancel or Close closes the window without applying changes. If the site in the record is not found in the company list, it remains selected; unless you change it, the record stays on the same site.
If you select Select… in the Site (company) field and save, the record is saved without site information.
Deletion
There is no deletion on this screen. Records are only added and updated. You can remove an unwanted spelling by editing the record and deleting it from the list; however, at least one word must remain in the list.
Record window fields
| Field | Required | Description / rule |
|---|---|---|
| Synonym words | Yes | Incorrect or alternative spellings users may type; separate with commas. Empty parts and leading/trailing spaces are ignored. If no words remain, the warning "Enter at least one word." appears. |
| Canonical word | Yes | The word searched instead of the synonyms. If empty, the warning "This field is required." appears. Leading and trailing spaces are not saved. |
| Site (company) | No | List of company names; loaded when the window opens. The selected company name is saved as the site ID of the record. If not selected, it remains as Select…. |
If any required field is invalid, Save is disabled and Enter does not save. When saving, the button shows "Saving…".
Common situations
- I don't see the New synonym button. Your account has view-only permission on this screen; contact your administrator for write permission.
- Save button is disabled. There is no valid word in the Synonym words field or the Canonical word is empty. Fields with only commas or spaces are considered empty.
- No options in Site (company) list. The company list loads when the window opens; wait briefly. If it cannot load, no warning is shown; saving without site selection saves the record without site info.
- "Something went wrong" notification when saving. The record was not saved; the window and entered values remain open. Check the notification details and try again.
- List says "No records found." Clear filters with Clear and try again.
Related screens
- Search words — Assign keywords and popularity scores to terms.
- Word mapping — Redirect a search term directly to a page.
- Search logs — See what spellings customers actually use.
- Using list screens — Common behaviors of filtering, sorting, and columns.