Search Configuration Jun 19, 2026 19 min read

How to Set Up Shopify Synonyms—and Prove They Work

Shopify synonym groups let correctly spelled terms act as substitutes in online-store search. The configuration takes minutes. The important work is proving that the failure is vocabulary, defining a group that does not broaden intent, and testing the live storefront after saving it.

This procedure covers Shopify Search & Discovery as documented on July 28, 2026. It does not assume that a synonym can repair product visibility, missing searchable fields, SKU matching, typos, filters, or a third-party search surface.

The shortest safe path

Verify the failure, write a five-query test set, create the smallest valid group, replay both the results page and predictive search, then keep or roll back the rule based on relevance—not result count alone.

Need help choosing terms?

Before the steps · Understand the change

A synonym changes retrieval; it does not repair the catalog

A shopper and a merchant can describe the same product family with different words. “Trainers,” “sneakers,” and “athletic shoes” may express one buying intent even when the catalog uses only one phrase. A synonym rule closes that vocabulary gap by allowing one term to retrieve products associated with another.

The rule does not create products, publish them, add missing fields, correct an identifier, or prove that the returned set is useful. It changes which documents can be considered for the query. Ranking still decides their order, availability still decides whether they can be sold, and the storefront still decides what the shopper sees.

This is why a no-result query is not automatically a synonym opportunity. “Sofa” and “couch” may be substitutes. “Sofa” and “living room” are related but do not promise the same product set. “Red trainers” contains a vocabulary term and a constraint that must survive the expansion. “AB-1042” is an identifier and should not be pushed through a broad vocabulary rule at all.

Good synonym boundary

The terms can replace one another in the same buying task

The intended product set is substantially the same, important constraints remain intact, and a reverse query does not change the meaning.

Wrong synonym boundary

The terms are merely adjacent, broader, narrower, or commercially convenient

The rule introduces products that fail the original task, conceals missing assortment, or turns a navigation request into an unbounded product search.

The merchant problem is governance, not typing terms into a form

A store can accumulate hundreds of rules that nobody can explain, test, or safely remove. The durable system starts with evidence from real query behavior, records why the group exists, compares the result set before and after, and has a clear rollback condition. The setup below is useful because it treats the synonym as a search change, not an admin chore.

Step 1 · Prove the problem

Confirm that vocabulary is the failing layer

Run the failed shopper term and the catalogue term on the same storefront surface. If “trainers” fails but “athletic shoes” returns the correct set, you have evidence of a vocabulary gap. If both fail, adding a synonym only hides the real defect.

Question

Does the expected product exist and appear in the Online Store?

If no

Fix product eligibility or publication first.

Product visibility

Question

Does the catalogue term retrieve the product on the same search surface?

If no

Investigate searchable fields, theme requests, or a replacement search app.

Retrieval

Question

Is the failed query a correctly spelled alternate name for the same intent?

If no

Route typos, identifiers, broader categories, and navigation intent elsewhere.

Vocabulary

Question

Should every term retrieve substantially the same product set?

If no

Do not create a synonym group; the relationship is too broad or directional.

Meaning

Start with the zero-results diagnostic when you cannot yet prove product eligibility, field coverage, or the responsible surface.

Where ParticleSearch fits · Evidence-backed query controls

How ParticleSearch turns synonyms into a reviewed search decision

ParticleSearch is a fit when the merchant wants to fix vocabulary gaps without treating every no-result query as a synonym request. The workflow starts with a shopper term and the products it currently returns. The merchant can review the gap, create a focused group, compare the proposed results with the live results, and publish only after the product set makes sense.

The same query-control workspace also supports ranking changes, hides, boosts, demotions, and redirects. That matters because a merchant should not be forced to use a synonym when the real intent is navigation, when one product needs a deliberate commercial position, or when an unsuitable product should be removed from a particular query.

Observed intent	ParticleSearch control	Why it fits
Two true substitute terms	Synonym group	The terms should retrieve substantially the same product set.
A query should open a collection, product, or page	Redirect	Navigation intent is clearer than pretending the query needs a broader product set.
The right products exist but their order is poor	Pin, boost, or demote	Candidate retrieval is working; the merchant is changing order, not meaning.
One product is unsuitable for one query	Query-level hide	The exception stays bounded instead of weakening the catalog or global relevance.

What you no longer need to worry about

You do not need to publish a synonym blind, remember why it was created, or use it as the answer to every search problem. ParticleSearch keeps the observed query, proposed change, before-and-after product order, published rule, and follow-up evidence in one merchant workflow.

Merchant judgment is still required. ParticleSearch can show the query and product evidence, but only the store can decide whether two phrases are true substitutes and whether an exception matches its commercial policy. See the merchant controls system and the detailed ParticleSearch query-tools guide.

Step 2 · Write the test first

Define what must improve—and what must not change

A successful save is not a successful search change. Before opening the admin, record the expected product set and at least one query that should remain unaffected.

Test	Example query	Expected result
Positive	`trainers`	Retrieves the intended athletic-shoe set after the group is saved.
Reverse	`athletic shoes`	Still retrieves that set; Shopify treats group terms as substitutes.
Mixed	`red trainers`	Preserves the red constraint while recovering the category vocabulary.
Negative	`work boots`	Does not broaden into athletic shoes.
Control	`running socks`	A nearby working result set remains stable.

Step 3 · Create the group

Configure the smallest group that expresses the equivalence

In Shopify admin, open the Search & Discovery app, open its synonyms area, and choose Create synonym group. Add the terms and give the group a clear internal name. The title is for administration; the terms determine storefront behavior.

Group builder model

Athletic shoe vocabulary

3 terms · one intent

Synonyms

sneakerstrainersathletic shoes

Every term should represent the same intended product set.

Keep the rule narrow

• Do not add adjacent categories.
• Do not add misspellings or SKUs.
• Do not fill a group to its limit.
• Record an owner and rollback condition.

A conceptual configuration model, not a screenshot of Shopify’s admin.

1–5

words per synonym

synonyms per group

1,000

synonyms store-wide

term reuse across groups

Shopify limits checked July 28, 2026. These are ceilings, not targets. Source: Search & Discovery settings.

Step 4 · Replay the storefront

Test the rendered experience, not the admin record

Save the group, open a clean storefront session, and run the judged queries. Inspect the first useful products, not only whether the page contains any result. Repeat the test in the predictive dropdown because it can use a different request and Shopify’s Search & Discovery analytics exclude predictive interactions.

Results page

Record count, first useful result, obviously irrelevant results, and retained filters.

Predictive dropdown

Record which resource types appear, suggestion order, and whether the theme exposes the expected product.

Mobile interaction

Use a small viewport and keyboard. Check truncation, tap targets, correction language, and the path from suggestion to product.

Step 5 · Diagnose a failed release

A saved synonym can still be the wrong repair

Symptom

The catalogue term fails too

Likely boundary

This is not a synonym problem yet.

Next test

Check product status, Online Store publication, searchable fields, and the actual results provider.

Symptom

The results page works; the dropdown does not

Likely boundary

Predictive and regular search are separate surfaces.

Next test

Inspect the predictive request, resource types and fields, theme rendering, and any third-party autocomplete.

Symptom

SKU or barcode still fails

Likely boundary

Shopify excludes SKU and barcode matches from synonym processing.

Next test

Use an identifier-search diagnostic instead of expanding the group.

Symptom

A query using search syntax ignores the group

Likely boundary

Shopify excludes search-syntax queries from synonym processing.

Next test

Test the plain-language query separately and decide whether the syntax is intentional.

Symptom

Shopify will not accept a term

Likely boundary

The term may already belong to another group or exceed a documented limit.

Next test

Find the existing group, review the meaning boundary, and merge only if every term is interchangeable.

Symptom

Results increased but relevance fell

Likely boundary

The group joins related concepts rather than true substitutes.

Next test

Remove the ambiguous term, restore the prior state, and use taxonomy, filters, or merchandising instead.

Shopify documents that synonyms do not apply to SKU or barcode matches and do not apply when a query uses search syntax. Common singular/plural and standard spelling variations generally do not need synonym groups. See the search behavior reference and the typo-tolerance guide.

Step 6 · Measure and govern

Keep the group only when relevance improves

Log the group name, terms, owner, source query family, test set, save date, and rollback condition. Compare the affected results-page queries over a matched period. Shopify’s reports include searches with no results, searches with no clicks, click rate, and purchase rate; they do not include predictive-search interactions.

Signal	Improvement	Warning	Decision
Judged relevance	Positive terms recover the intended set.	Negative or control queries broaden.	Required release gate.
No-result searches	Affected query family declines.	Rate falls only because irrelevant products appear.	Use with relevance review.
Click and purchase rate	Downstream behavior improves on the family.	Volume is too small or seasonality changed.	Observe longer; do not invent impact.
Predictive search	Required suggestions improve in direct replay.	Analytics appear positive while dropdown remains weak.	Track separately.

Analytics scope checked July 28, 2026. Source: Shopify Search & Discovery analytics.

Use the synonym governance guide to decide which terms belong together. Use the Search & Discovery settings guide when you are unsure which Shopify control owns the symptom.

The release is complete only when the intended live surfaces pass, negative and control queries stay clean, and the rule has an owner who can reverse it.