Define one-way or two-way relationships to map buyer search words to your catalog data.
Connect alternate phrasing, informal words, or regional terms to your exact product names to
make sure that buyers find relevant products even when they use search terms that don’t exactly
match your catalog.
In the navigation sidebar, select a store from the Store
dropdown.
Select Merchandising | Synonym Rules.
Click New Rule.
Select a rule type: One-Way or Two-Way.
One-Way (A → B): Query A retrieves products matching term B, but query B doesn't
retrieve products for term A. Use one-way rules when buyers are likely to use informal
or alternative terms to search for formal product names. For example, with a one-way,
"phone charger" → "lightning cable," searching for "phone charger" returns products
labeled "lightning cable," but searching for "lightning cable" returns only products
with that exact term.
Two-Way (A ←→ B): All terms are treated as equals. Query A retrieves products for
B, and query B retrieves products for A. Use two-way rules when terms are true synonyms.
For example, with a two-way rule "couch" ←→ "sofa," searching for either term returns
products labeled with both terms.
Select the locales for this rule.
You can set the rule for a specific locale such as en-US, or for all locales.
Enter the search term that buyers use.
For one-way rules, the search term is the query term (A). For two-way rules, the
search term is one of the equivalent terms.
Enter the matching term or terms from your catalog.
For one-way rules, enter the matching term in your catalog as the target term (B). For
two-way rules, enter all equivalent terms separated by commas.
Click Save.
If the rule conflicts with an existing rule, a warning appears. Common conflicts
include phrase overlaps, redefining a term that exists in a two-way rule, or duplicates.
We use three kinds of cookies on our websites: required, functional, and advertising. You can choose whether functional and advertising cookies apply. Click on the different cookie categories to find out more about each category and to change the default settings.
Privacy Statement
Required Cookies
Always Active
Required cookies are necessary for basic website functionality. Some examples include: session cookies needed to transmit the website, authentication cookies, and security cookies.
Functional Cookies
Functional cookies enhance functions, performance, and services on the website. Some examples include: cookies used to analyze site traffic, cookies used for market research, and cookies used to display advertising that is not directed to a particular individual.
Advertising Cookies
Advertising cookies track activity across websites in order to understand a viewer’s interests, and direct them specific marketing. Some examples include: cookies used for remarketing, or interest-based advertising.
