Query Replacements

Some retailers need the ability to override specific terms in a customer's search query. This occurs when a customer searches for a keyword that is no longer relevant and receives results that are not useful. The most common use case for query replacement is to help users with common spelling errors. On the Query Replacement page, you can configure words that will replace other keywords.

Query replacements serve a different function than synonyms. With synonyms, the system will find similar items and include the original search term as well, but query replacements will ignore the original search term and replace it with the term defined on this page.

Tip: Use the Zero Results Report to find search terms that return no results — such as common misspellings or outdated product names — and replace them with more relevant terms to improve the shopper experience.

• Another retailer selling phone cases has a query replacement configured to change the search term "iPhone 10" to the replacement term "iPhone X".
• Another store sells products by the brand "Happy Pets", but the manufacturer has changed its name to "Wonderful Pets". If shoppers still search for "Happy Pets", setting up a query replacement for "Happy Pets" to "Wonderful Pets" will direct shoppers to relevant results.

Add Query Replacement

Add a replacement by clicking the "+ Add Query Replacement" button in the top right corner of the page.

A new window will appear and allow you to enter "Original Search Term(s)" (the word or phrase you wish to replace) and a "Replacement Search Term" (the word or phrase you wish to use instead). Once you have defined the query and its replacement, click the "Create Query Replacement" button in the bottom right corner, or click the "Discard" button to cancel the creation of a new query replacement.

On the main Query Replacements page, the following information will appear:

Search all query replacements box

Type in a word or phrase to search among all query replacements that have been defined; the system will automatically displays matching results as you type.

Search Term(s)

The Search Term(s) column displays the original keyword(s) to be replaced.

Replacement Term

The Replacement Term column displays the replacement word or phrase that will be used instead of the original keyword.

Status

Activate the "Enable" toggle to ensure that the replacement query is on. This change automatically saves. To disable a replacement without deleting it, toggle this setting to disabled by clicking it.

Note: Any updates to this setting will take effect the next time your data is synced.

Options

Click the "..." icon to see the Edit and Delete options.

Edit

Edit any replacements defined here by clicking the "Edit" option.

Delete

Remove a query replacement by clicking the "Delete" option.