Configure the engine

Synonyms, stop words and rules

Teaching the engine your customers' vocabulary.

Your catalog uses your company's words. Buyers use their old supplier's words, their ERP's words, and whatever the fitter on site calls it. A synonym list is the cheapest quality improvement available on a B2B shop, and it is never finished.

Before you begin. Build the list from what buyers actually typed, not from a brainstorm in a meeting. A synonym invented at a desk is a rule you will maintain forever for a query nobody makes.

Two-way and one-way synonyms

The difference matters more than it sounds, and getting it backwards causes wrong results rather than missing ones.

KindBehaviourUse it for
Two-wayEvery term finds every other termTrue equivalents: V4A1.4571A4InoxNIRO
One-wayThe query term also finds the target; not the reverseNarrower → broader: SchlauchbinderSchlauchschelle

Use two-way when the terms are interchangeable in both directions. Stainless steel designations are the classic case: whichever one a buyer types, they mean the same material.

Use one-way when one term is more specific than the other. Inbusschraube should find hexagon socket screws; searching for the generic term should not force every result to be an Inbus. Reversing this is how a shop ends up returning the whole fastener range for a precise query.

Two-way synonyms are contagious. If SchraubeBolzen and BolzenStift are both two-way, a search for Schraube can return pins. Keep two-way groups small and genuinely equivalent; use one-way for everything that is merely related.

The five synonym families worth building first

  1. Trade name against norm name. V4A / 1.4571 / A4 / Edelstahl. Teflon / PTFE. Torx / TX / Innensechsrund.
  2. Regional and generational names. Schlauchschelle / Schlauchbinder. Muffe / Verbinder. The Innendienst knows these; write them down.
  3. Abbreviations. VA, NIRO, EPDM, PN16, DN50. Buyers type abbreviations far more than full names.
  4. English in a German catalog and back. bearing / Lager, hose clamp / Schlauchschelle. Even in a German-only shop, buyers type English terms for anything they learned from a datasheet.
  5. German compounds. SechskantschraubeSchraube, EdelstahlrohrRohr. One-way, from compound to head noun. This is the manual fix for the compound problem described in How search works, and there is no automatic one.

Stop words

Stop words are terms the engine ignores in the query. In German catalogs the useful list is short: für, mit, und, der, die, das, plus filler that buyers paste from their own systems — Stk, Pos, Artikel.

Be conservative. Two traps:

  • Do not stop-list anything that could be part of a code. A, S, M and T are words in some contexts and article numbers in others.
  • Do not stop-list units. mm, bar, V and A look like noise and are exactly what the buyer meant.

Redirect rules

Some queries should not return a result list at all. They should go somewhere.

QuerySends the buyer toWhy
AGB, ZahlungsbedingungenThe terms pageIt is not a product
Datenblatt HK-40The machine's documents pageThe buyer wants a PDF
HK-40The machine's spare-parts pageThe machine case
Retoure, ReklamationThe returns formSupport query in the search box
Kontakt, AnsprechpartnerThe contact pageFaster than the navigation

Redirects are underused and cost nothing. Take the top 50 queries from search analytics, find the ones that are not product queries at all, and redirect them. In most B2B shops that is between five and fifteen percent of all searches.

Pin and bury

A curation rule fixes the result list for one specific query: pin a product to a position, bury one out of the top results, or both.

Pin when there is a right answer and relevance will not find it on its own — your own brand's equivalent for a competitor's part number, the current model for a query that names a discontinued one, the standard variant when a query returns fifty lengths of the same screw.

Bury when a product matches technically and is wrong commercially: a discontinued article that still matches its own name, an accessory that outranks the machine it belongs to.

Both are per query, and optionally per channel and per language. Both can carry a validity window, which is how a campaign pin removes itself.

Curation is the override of last resort, and it rots. A pinned product that is later discontinued leaves a rule pointing at nothing. Review pins quarterly and delete anything you cannot justify in one sentence. If you find yourself pinning more than a few dozen queries, the ranking configuration is wrong — fix that instead, in Merchandising.

Steps

  1. Export the last quarter's queries from search analytics, sorted by frequency, with the zero-result ones marked.
  2. Sit with someone from the Innendienst for an hour. They will recognise half the list on sight and tell you what the buyer meant.
  3. Enter the equivalences as synonyms — two-way or one-way per the table above — scoped to the right language.
  4. Turn the non-product queries into redirects.
  5. Add pins only where you can name the reason.
  6. Save. Synonym and rule changes apply to new queries without a reindex.

What to check

  • Search each new synonym term. It must return the same articles as its equivalent.
  • Search the other direction of every one-way rule. It must not be narrowed.
  • Re-run the twenty-search test from Search and product discovery and compare the score against last time.

Next