The Complete Guide to Shopify Search Synonyms & Redirects
How Shopify search synonyms work, when to use two-way groups or one-way mappings, how to handle misspellings like 'tshirt' and words like 'beanie', and a step-by-step setup with examples.
Search synonyms are one of the quickest ways to rescue searches that would otherwise find nothing. They teach your store that the words shoppers use mean the same thing as the words in your product catalogue, without editing a single product.
This guide covers how synonyms work on Shopify, the difference between two-way synonyms and one-way mappings (often called search redirects), how to handle misspellings and spelling variants, and how to set everything up step by step.
What are search synonyms?
A search synonym tells your store's search: "when someone searches for this word, also find products that match that word."
Example: your hats are called "Winter Hat", but shoppers search for "beanie". Without a synonym, "beanie" can return 0 results. With one, "beanie" shows your winter hats.
Synonyms are useful for:
- Different names for the same thing: beanie / winter hat, hoodie / sweatshirt, couch / sofa.
- Regional vocabulary: jumper / sweater, trainers / sneakers, trousers / pants.
- Spelling variants: colour / color, jewellery / jewelry, grey / gray.
- Compound words: tshirt / t shirt / t-shirt.
Two-way synonyms vs one-way mappings
This is the most important decision when you set up synonyms.
Two-way synonym groups
In a two-way group, every word finds products matching every other word. This is how synonyms work in Shopify's free Search & Discovery app: the terms in a group are treated as exact matches for one another.
Two-way works well when the words really are interchangeable:
- colour, color
- sofa, couch, settee
- tshirt, t-shirt, tee
One-way mappings ("search redirects")
A one-way mapping only works in one direction. Searching for word A shows results for word B, but searching for B doesn't pull in A.
One-way is the better choice when the words aren't truly equal:
- "gift" → "gift card": someone searching "gift" may want a gift card. Someone searching "gift card" doesn't want every product tagged "gift".
- "beanie" → "winter hat": fine either way, but a one-way mapping keeps "winter hat" results exactly as they are.
- A product you don't stock → the closest thing you do: "rain poncho" → "rain jacket". You don't want "rain jacket" searches to start matching on "poncho".
Many merchants call these search redirects, because the shopper's search is redirected to another term. Note that Shopify's built-in URL redirects (under your Online Store navigation settings) are designed for moving page addresses, such as an old product URL to a new one. They aren't built for mapping search terms, so for search you need synonyms or a one-way mapping tool.
How Shopify's built-in synonyms work
Shopify's Search & Discovery app lets you create synonym groups. Key facts from Shopify's documentation:
- Each group can hold up to 20 terms, and a store can have up to 1,000 synonyms in total.
- A term can belong to only one group.
- Each term can be a single word or a phrase of up to 5 words. Phrases are matched as a phrase.
- Synonyms don't apply to SKU or barcode fields, or to searches that use search syntax.
- Synonyms help products rank, but don't guarantee they appear at the very top.
Misspellings: Shopify's search includes built-in typo tolerance, so you don't need synonyms for every small typo. Shopify notes that alternate spellings of compound words (open, closed or hyphenated, like "t shirt", "tshirt" and "t-shirt") aren't handled by default, so add those as synonyms if your shoppers use them.
Setting up synonyms in Search & Discovery
- Install Search & Discovery (free, made by Shopify) from the Shopify App Store.
- Open it from Apps in your admin and go to its search settings.
- Find the synonyms section and create a new synonym group.
- Enter the terms that should match each other (for example:
sofa, couch, settee) and save. - Test on your storefront: search for each term and check that the right products appear.
Setting up one-way synonyms with ZeroFinder
ZeroFinder (our app) approaches synonyms from the other end: it starts with the searches that actually failed on your store, then lets you fix each one with a one-way mapping.
- Install ZeroFinder and switch on the tracker in your theme editor (one toggle).
- Let shoppers search. Failed searches appear on your dashboard, ranked by how often they happen.
- Click "Fix with a synonym" next to a failed term, for example
beanie. - Type the word your products use, for example
winter hat, and save. - It goes live straight away. Shoppers searching "beanie" now see your winter hats, both on the search results page and in the search drop-down on themes that use Shopify's predictive search (like Dawn). The search box on the results page shows "winter hat", so shoppers can see what they're looking at.
Synonyms are part of ZeroFinder's Growth plan. The free plan lets you find the failing searches first.
You can use both tools together: Search & Discovery groups for words that are truly interchangeable, and ZeroFinder mappings for one-way fixes driven by what's actually failing.
Common synonyms and redirects to consider
Don't copy a list wholesale. Check your own no-results report and add what your shoppers actually type. These are common patterns to look for:
| Shopper types | Map to | Type |
|---|---|---|
| beanie | winter hat | One-way (or two-way) |
| tshirt, t shirt | t-shirt | Two-way group |
| colour | color | Two-way group |
| jewellery | jewelry | Two-way group |
| grey | gray | Two-way group |
| jumper | sweater | Two-way group |
| trainers | sneakers | Two-way group |
| hoody | hoodie | Two-way group |
| gift | gift card | One-way |
| rain poncho | rain jacket | One-way (not stocked) |
| swim suit | swimsuit | Two-way group |
Best practices
- Start from data, not guesswork. Your no-results list shows which words actually fail. A synonym for a word nobody searches adds clutter and no sales.
- Map to words that exist in your catalogue. A synonym only helps if the target word appears in your product titles, types, tags or descriptions. Test the target term first: if it returns nothing, the synonym will too.
- Prefer one-way when the words aren't equal. Broad words like "gift", "sale" or "kids" can flood results if you put them in a two-way group.
- Don't chain mappings. Map each term straight to its final target ("hoody" → "hoodie", not "hoody" → "hood" → "hoodie").
- Keep regional variants together. If you sell internationally, a few two-way groups (colour/color, jewellery/jewelry) cover a lot of searches.
- Test every change on your storefront, both in the search results page and in the search drop-down.
- Review monthly. Remove mappings for products you no longer sell, and add new ones as your catalogue and seasons change.
Synonyms aren't the only fix
Synonyms solve vocabulary problems. They won't help when:
- the product isn't published to your Online Store sales channel;
- out-of-stock products are hidden from search; or
- you don't sell the item at all. In that case, map the term to the closest alternative and treat the search as demand data for future stock.
For a full diagnosis of empty search results, read How to Fix "0 Results Found" Pages on Shopify. To find the searches worth fixing in the first place, see How to See What Customers Are Searching for on Your Shopify Store.