Synonyms Tab

Site Search > Relevance > Basic Relevance > Synonyms Tab

---

The Synonyms Tab of the SearchStax Site Search solution’s Basic Relevance screen lets the Business User augment queries using synonyms.

How it Works

How the synonym feature works:

• The business user enters a synonym pair, consisting of a trigger phrase and a synonym phrase.
• When a query contains the trigger phrase, Site Search automatically inserts the synonym into the query string.

Key Benefits

• Synonyms transparently guide the search user to relevant content by broadening the terms of the query.

Setting up Synonyms

Synonyms can be set up manually, and can also be uploaded from CSV or TXT files.

Manual Entry

To enter a synonym pair manually:

1. Enter a trigger word/phrase in the Word field.
   • When this phrase appears in a query, it triggers a synonym expansion.
   • Solr synonyms must be literal strings. They do not support any kind of regex or wildcard operations.
2. Select a right-arrow (→) or a double-arrow (↔) in the Is droplist.
   • Some synonyms are one-way (this phrase implies that synonym), while others are symmetrical (each phrase implies the other).
3. Enter the synonym phrase in the Synonym to field.
   • This phrase will be inserted in the query string to broaden the search results. If you would like to enter multiple terms, separate them by commas.
4. Click the plus button (+) to add the synonym pair to the list of synonyms.
5. (Not shown). Click the Publish button to make the change active and persistent.
   • Both the Draft and Publish buttons save your changes. Publish makes the changes visible in the Search Experience.

Upload a File

Site Search lets you upload a dictionary of synonym pairs.

1. Prepare the upload file as described in Synonyms: Upload Format.
   • Maximum file size is 10MB. When you upload a file, it appends words to the previous list. Duplicate entries are ignored. Site Search can accommodate up to 25000 synonym entries.
2. Use the Choose File button to select the file.
3. Click Upload.
   • The new synonyms will appear in the list.

Table Utilities

The table of synonym pairs offers some convenient features:

1. At the left are controls to select one or more synonym pairs for global operations (such as delete).
2. Click on a column heading to re-sort the table by the values in that column.
3. On the right are controls to:
   • Filter the list by searching for a keyword.
   • Download the synonyms to a CSV file.
   • Delete selected synonyms.

Examples

Some synonyms are one-way, while others are symmetrical. For example, when the user types in “William,” also search for “Bill” at the same time. (But when they type in “Bill”, don’t search for “William”. It might be a phone bill.)

When the user types in either “lose” or “loose”, search for both. 

When they type “Tom”, search for multiple alternatives.

Best Practices and Tips

• Examine the list of No Results Searches for inspiration about synonyms.

Troubleshooting and Common Issues

• When you upload a synonym file but no new synonyms appear in the list, check the file format. The upload can fail silently.
• When you enter or upload synonyms and can’t find them later, be sure to Publish your changes.
• Be sure to regenerate your Search UI App after making any changes to the Search Experience.