RelevanceRail
RelevanceRail answers

Synonym Rules Are Maintenance Debt: Auditing the Search Dictionary Nobody Owns

Open the synonym table in a store search that has run for a few years and you will find archaeology. Sofa equals couch equals settee, added by an agency. A brand nickname mapped to a category, added during a campaign that ended long ago. A misspelling correction for a product that was delisted. Each rule made sense to someone, once, and each one still fires on every matching query today, quietly deciding what a shopper sees. Synonyms are code. They change results as surely as a ranking change does, and they are usually the least reviewed code in the whole search stack.

Expansion can hurt as much as it helps

A synonym expands a query, which helps when the catalog's language differs from the shopper's: trainers against sneakers, nappies against diapers. It hurts when the expansion drags a precise query into a broader, weaker result set, or when two synonyms chain and a specific term ends up retrieving a category the shopper never asked for. The classic damage is a one way synonym created for a single campaign, a seasonal term pointed at a collection, left live all year. Nobody notices because search still returns something. Relevance erosion of this kind does not produce zero results pages or alerts. It produces slightly worse pages, at scale, indefinitely.

Audit by firing, not by reading

Reading a synonym list in a spreadsheet tells you what the rules say. Search logs tell you what they do. Pull the rules that actually fired in the last ninety days, with the queries they fired on and the click and conversion outcome of those sessions, and set that beside the rules that never fired at all. Dead rules are candidates for deletion unless someone can name the seasonal moment they exist for. Fired rules with poor outcomes get tested with the rule off. You will find, in most stores, that a short list of expansions does nearly all the useful work and a long tail of rules does nothing or quiet harm.

Give the dictionary an owner and a diary

Every rule should carry a reason, a date, and a name. New rule requests state the query evidence: sessions searched this, found that, bought nothing. Seasonal rules get an expiry date at creation, not a promise to remember. The owner reviews firings quarterly, which is an afternoon's work once the reporting exists. Without that ownership, the synonym table becomes the place merchandising requests go when nobody wants to fix the underlying problem, which is usually product data: titles and attributes that do not contain the words shoppers actually use. Fix the product data and half the synonym requests evaporate.

Prefer product data over query patches

A synonym is a patch over a gap between shopper language and catalog language. Some gaps are permanent, regional vocabulary, brand nicknames, and synonyms are the right tool there. Most gaps are fixable at the source: add the common term to the product's attributes, correct the category name that nobody outside the company uses, include the material word buyers search for in the title. Source fixes help every channel, site search, filters, external search, recommendations, while a synonym helps one engine on one store. When a synonym request lands, ask first whether the catalog should learn the word instead.

Keep reading

Related guides on this site: Vector Search vs Keyword Ranking on a Store: What Each One Misses Reading a Zero Results Log: The Weekly Triage That Fixes Search Practical answers about personalization.

Frequently asked questions

What is a search synonym rule?

A mapping that tells site search to treat one term as another, or to expand a query with related terms, so shoppers find products described in different language in the catalog.

Can synonyms make search worse?

Yes. Over broad or stale expansions can pull precise queries into weak result sets, chain into unrelated categories, or outlive the campaign they were created for.

How often should synonyms be reviewed?

Quarterly is practical for most stores, using firing data from search logs: which rules fired, on which queries, and what those sessions did next.

© 2026 RelevanceRail