Shopify Search Synonyms: Setup, Limits and What to Map

Shopify search synonyms are groups of terms you tell the store to treat as equivalent, so a shopper who types “sneakers” also sees the products you titled “trainers.” You build them in the free Search & Discovery app. They work well for plain vocabulary gaps, and they have real limits: multi-word terms behave like exact phrases, codes are ignored, and they cannot fix data your catalog doesn’t contain. This guide covers setup, those limits, and how to decide which synonyms deserve a slot.

TL;DR

• Create synonym groups in the Search & Discovery app for words shoppers use that your product titles and tags don’t.
• Keep groups small and literal. Each group holds up to 20 synonyms and the store up to 1,000, and a synonym can’t live in two groups.
• Multi-word synonyms are matched as phrases, and synonyms never apply to SKU or barcode fields.
• Most zero-result queries are not vocabulary problems at all. Check your search log before you add terms.
• If your list keeps growing, that is the signal to look at semantic search or a managed layer instead of more manual rules.

Table of Contents

• What synonyms actually do in Shopify search
• How to set up a synonym group
• The limits that trip merchants up
• Check the log before you add a single synonym
• Which synonyms are worth mapping first
• Mistakes that make synonyms hurt relevance
• When manual synonyms stop scaling
• Our perspective
• A 30-minute routine to keep synonyms healthy
• Want someone else to run this?
• FAQ
• Sources

What synonyms actually do in Shopify search

Shopify’s storefront search is keyword based. It looks for the words a shopper typed in your product titles, descriptions, tags, vendors and other indexed fields. If a shopper types “couch” and every product says “sofa,” a pure keyword match returns nothing, even though you sell exactly what they want.

A synonym group closes that gap by linking the terms. The Shopify Help Center documents how synonyms and product boosts work inside the Search & Discovery app, and it is the page to check when something behaves oddly.

A simple fashion example: you sell scrunchies, and a good share of your shoppers say “hair ties.” Fyresite uses that same example for why a group helps shoppers regardless of which term they know.

The point is not to guess every possible phrase. It is to cover the handful of words your real customers use that your merchandising team never would.

How to set up a synonym group

1. In your Shopify admin, open the Search & Discovery app. If it isn’t installed, it is free in the Shopify App Store.
2. Go to the search settings and open the synonyms section.
3. Add a group. Enter the terms that should be treated as the same, for example “hoodie,” “sweatshirt,” “pullover.”
4. Save, then test on your live storefront in a private window, using the exact words shoppers type.
5. Re-test after a few minutes. Changes can take a moment to apply, and a stale browser cache can mislead you. Merchants in this Shopify community thread troubleshoot the same issue by double-checking spelling and clearing the cache.

Two habits save time. Write down why each group exists (a note in a spreadsheet is enough), and test both directions: if “hoodie” finds sweatshirts, check that “sweatshirt” finds hoodies too.

The limits that trip merchants up

Size limits

Per Shopify’s documented limits as summarized by one Shopify agency, each synonym can contain up to 5 words, a group can contain up to 20 synonyms, and a store can have up to 1,000 synonyms in total. The same synonym cannot belong to multiple groups. Another setup guide confirms the 20-per-group and 1,000-per-store figures. Shopify can change these, so confirm in the Help Center before planning a large list.

That last rule matters more than it sounds. If “top” belongs to a group with “shirt” and you later want it with “tank,” you can’t simply add it twice. Your groups need a design, not a pile.

Multi-word synonyms behave as phrases

According to Shopify, multi-word synonyms are treated as phrase searches. Say a group contains “belt bag” and “sling.” A search for “belt bag” matches only where those words appear together in that order. A search for “sling” matches products containing “sling” and also those containing the phrase “belt bag.”

In practice, don’t assume a phrase synonym is symmetrical or flexible. “Bag belt” or “belt shoulder bag” won’t match the phrase. Test the exact variants your shoppers use.

Codes are not covered

Synonyms are never applied to SKU or barcode fields, per the same Shopify documentation. A shopper searching by a product code has to type it exactly. If you have wholesale or repeat buyers who search by code, that is a separate problem from synonyms.

Predictive search and semantic search are different things

Shopify’s two search types are the results page you reach after pressing Enter and the predictive dropdown that suggests results as you type, as its search behavior page describes. Shopify’s AI-based semantic understanding is restricted to Grow, Advanced and Plus plans with catalogs under 200,000 products, and it does not apply to predictive search on any plan. So a store can have semantic matching on the results page and still show a weak dropdown. Our note on predictive search setup and limits goes through what you can and can’t control there.

If you’re also working on how shoppers find you from Google, that is a different channel with different tools. A Shopify SEO automation platform addresses that side, while synonyms only shape what happens after a visitor is already in your store.

Check the log before you add a single synonym

It is tempting to open the app and start typing every word you can think of. Resist that. The better order is data first.

Pull your search terms report from Shopify analytics and list the queries that returned nothing or led to an exit. Then sort each one into a bucket:

The split matters. According to an analysis from Anglera, a typical e-commerce catalog sees 10 to 15% of queries return zero results, while top-performing search engines get that under 2%. The same source notes that roughly 60 to 70% of zero-result queries are coverage gaps, where the shopper wants an attribute that isn’t in your structured catalog. Synonyms can only fix vocabulary gaps like sofa versus couch. They can’t invent missing product data.

That is a useful reality check. If you’ve added 80 synonym groups and your zero-result rate hasn’t moved, the problem probably sits in the catalog, not the dictionary.

Which synonyms are worth mapping first

Start with the highest-volume failures and the most common naming splits.

Category names that vary by region or generation

“Sweater” and “jumper,” “pants” and “trousers,” “sneakers” and “trainers,” “tote” and “shopper.” For a US store, put the American term in your titles and map the others. If you sell internationally, the opposite may be needed.

Casual words for formal product types

“Jacket” and “coat” is the classic case. A UX study summarized by NoPAccelerate points out that shoppers use different terms for the same product, and many sites don’t return relevant results for the alternate wording. It also reports that failing to support common query types, including abbreviations, symbols and non-product terms, affects 41% of e-commerce sites. Small brands competing with big retailers lose here, because large stores have usually tuned this for years.

Abbreviations and spec language

The Anglera piece gives examples like “waterproof” versus a rating code such as IP67, and “15mm” versus “15 millimeter.” In fashion, think “XL” versus “extra large,” “tee” versus “t-shirt,” “denim” versus “jeans.”

Brand nicknames and style words

Shoppers search for “Chelsea boots,” “mom jeans” or “slip dress” without caring about your title format. If those words appear in no field of your product, a synonym can bridge it, but a tag or metafield that carries the term is often more durable.

Mistakes that make synonyms hurt relevance

Mapping things that are only related. “Dress” and “skirt” are not equivalents. If a shopper wants a dress and sees skirts, you’ve added noise. Keep groups to genuine equivalents. We cover the trade-off in more detail in our ecommerce synonym strategy guide.

Creating collisions. A word that means two things, like “top” (a shirt, or a phone case top) or “slip” (a dress, or a slip-on shoe), can pull in wrong results once it joins a group. If you are technical, three quick tests for synonym collisions will catch most of them.

Forgetting other languages. A group written in English does nothing for a shopper searching in Spanish or French. See when multilingual synonyms break if you sell in more than one language.

Using synonyms to fix typos. A misspelling is not a synonym. Adding “sweter” to a group wastes a slot. Typo tolerance should handle it, and our fuzzy search guide explains what to check before adding an app.

Ignoring stop words and special characters. Some misses come from filler words or punctuation, not vocabulary. Read about stop words in Shopify search and special characters before blaming your synonym list.

When manual synonyms stop scaling

Manual groups are a good fit for a small catalog with a clear vocabulary problem. They get harder as you grow:

• Every new product line brings new words, and each one needs a human to notice.
• The 20-per-group and 1,000-per-store caps put a ceiling on coverage.
• Phrase-only matching means long natural queries like “something warm for a fall wedding” don’t benefit.
• Nobody owns the list, so it drifts out of date.

Semantic search tries to handle meaning rather than exact wording, which is why Shopify has been building it into the app. If you want to understand where it helps and where plain keyword matching still wins, read semantic versus keyword search for Shopify, and for the failures that cost the most, fixing the top 20 search failures.

Our perspective

We spend our time looking at what real Shopify shoppers type into real stores, and the pattern is consistent: merchants treat synonyms as the whole answer because it is the visible tool. It is one tool among several.

A synonym list is a record of past guesses. It covers the words someone thought of, on the day they thought of them. Shoppers keep inventing new ones, and they misspell, abbreviate and write full sentences. So we treat synonym mapping as one input to query understanding, alongside typo tolerance, semantic matching and merchandising, all tuned against the store’s own search data rather than a generic dictionary.

Our advice to any merchant, whether or not they work with us: sort your failed queries into vocabulary, typo, coverage and phrasing before you touch the app. Fix each with the right tool. You will write fewer synonyms, and the ones you write will matter. See how we approach this on our typos and synonyms page and our query understanding page.

— Barikreativa

A 30-minute routine to keep synonyms healthy

1. Export or review your top failed searches from the last 30 days.
2. Label each as vocabulary, typo, coverage, phrasing or code.
3. Add synonyms only for the vocabulary bucket, grouped by genuine equivalence.
4. Test each term on mobile and desktop, including the singular and plural.
5. Note any coverage gaps and send them to whoever writes product data.
6. Repeat monthly. Search language shifts with seasons and trends.

If you want a ready-made structure for this review, our free Shopify search audit checklist walks through it, and our post on five ecommerce search metrics worth tracking tells you which numbers to watch.

Want someone else to run this?

If you’d rather not maintain dictionaries yourself, we run search for Shopify stores as a managed service. We handle typo tolerance, semantic matching, synonym mapping and ongoing tuning from your store’s own data, with no coding on your side. You can start with a free audit to see what your current search is missing, or see how a 30-day pilot, setup and monthly retainer work. If you’re already weighing the app you have, here is how we compare to Search & Discovery.

FAQ

How many synonyms can I add in Shopify?

Each synonym can contain up to 5 words, a group up to 20 synonyms, and a store up to 1,000 synonyms in total, according to one Shopify guide. A synonym can’t belong to more than one group. Check the Shopify Help Center for current numbers before you plan a big list.

Why are my Shopify synonyms not working?

The usual causes are a typo in the term, a multi-word synonym that only matches as an exact phrase, or a cached page. Synonyms also never apply to SKU or barcode fields. Test in a private window with the exact words a shopper would type.

Do synonyms fix misspellings?

No. A misspelling is a different problem from a vocabulary gap, and spending a synonym slot on it is wasteful. Typo tolerance or spell correction is the right fix, and our spell correction audit shows how to measure the damage.

Should I use synonyms or semantic search?

Use both where you can. Synonyms give you precise, predictable control over a few known terms. Semantic search handles natural-language queries you could never list by hand, but Shopify limits it by plan and catalog size, and it doesn’t cover predictive search.

Sources

• Shopify Help Center: Modifying search
• Shopify Help Center: Search behavior in your online store
• Anglera: What your on-site search logs reveal about catalog gaps
• NoPAccelerate: E-commerce search query types
• Media Plus: Shopify semantic (AI) search setup
• Fyresite: Semantic search, Shopify’s AI search tool
• Shopify Community: Why aren’t my webshop synonyms functioning properly?

Recommended

• Shopify Predictive Search: Setup, Customization, and Limits
• When Shopify Multilingual Synonyms Break for Merchants
• For Shopify Developers: Fix Synonym Collisions in 3 Quick Tests
• Shopify Search Stop Words: Fix Misses Without Editing the List