Table of contents :

Synonyms: The Simplest Way to Improve Search

100-days-of-algolia-033

Table of contents :

When shoppers use a different word from the one stored in your WooCommerce catalog, a technically correct search can still return poor results. A customer may search for sneakers while the product title says trainers, or search for hoodie when the catalog uses sweatshirt.

Algolia synonyms solve this mismatch without changing product data. They allow multiple search terms to match the same records, making them one of the fastest improvements an agency can deliver for an existing store.

What synonyms do in Algolia

A synonym tells Algolia that two or more terms should be treated as related during search. For example, a synonym group containing sneakers and trainers can make products indexed with either term discoverable from both searches.

This is different from typo tolerance. Typo tolerance helps with misspellings such as snikers. Synonyms handle vocabulary differences such as trainers versus sneakers. Both features can be useful, but they solve different problems.

Common WooCommerce synonym opportunities

  • Regional language: trainers and sneakers, or trolley and luggage.
  • Abbreviations: tv and television, or ssd and solid state drive.
  • Product terminology: hoodie and hooded sweatshirt.
  • Material or category wording: couch and sofa.
  • Internal and customer language: a manufacturer term and the phrase shoppers commonly use.

Two useful synonym patterns

Equivalent synonyms

Use an equivalent synonym when every term should return the same search intent. A group such as sofa, couch, and settee is appropriate when the store treats those terms as interchangeable.

In Algolia, this is represented by a synonym record containing the equivalent terms. The search behavior is effectively bidirectional: searching for any term can match records associated with the others.

One-way synonyms

Use a one-way synonym when a specific input should expand to a broader or preferred catalog term, but the reverse expansion would be misleading. For example, a shopper search for iphone charger might be mapped to lightning cable in a catalog where that is the relevant product terminology.

One-way mappings should be used carefully. Expanding a broad term into a narrow term can hide relevant products or create unexpected results. If both directions represent the same customer intent, an equivalent synonym is usually safer.

Adding synonyms through the Algolia dashboard

For a small set of changes, the Algolia dashboard is often the quickest workflow. Open the relevant index, go to the configuration area, and add a synonym record. Depending on the Algolia dashboard version, the interface may label the options as equivalent or one-way synonyms.

  1. Identify the production index used by the WooCommerce search experience.
  2. Add the terms that represent the same intent.
  3. Save the configuration and test several queries, including longer phrases.
  4. Verify the change in the storefront and in any autocomplete interface.

Synonyms are index configuration, not product attributes. If a store has separate indices for locales, currencies, or customer groups, apply the relevant synonym configuration to each index.

Managing synonyms as code

Agencies should usually manage important synonym sets through a repeatable deployment process rather than relying only on manual dashboard edits. Algolia provides APIs and client libraries for creating, updating, listing, and deleting synonym records.

A conceptual equivalent synonym record looks like this:

{
  "objectID": "footwear-sneakers-trainers",
  "type": "synonym",
  "synonyms": ["sneakers", "trainers"]
}

A one-way synonym uses a source term and one or more target terms. Use the exact request format supported by the Algolia client and API version used by the project, then deploy the records to every required index.

Give each record a stable objectID. Stable identifiers make updates predictable and prevent duplicate records when a deployment runs more than once. Keep the source list in version control, review changes like code, and separate development, staging, and production credentials.

How to find high-value synonyms

Start with search analytics instead of guessing. Review queries that produce no results, queries with low click-through rates, and searches where shoppers immediately reformulate their wording. Compare those terms with product titles, categories, attributes, and editorial content in the WooCommerce catalog.

For example, if shoppers frequently search for waterproof trainers but the catalog uses water-resistant sneakers, test whether a synonym for the base terms improves discovery. Do not automatically create a phrase-level synonym when separate term matching and ranking already produce the desired results.

Important implementation details

  • Test phrase meaning: A word can have different meanings in different categories. Do not make apple and fruit synonyms on a store that sells both food and electronics.
  • Prefer search intent over dictionary similarity: Two words may be linguistically related but lead shoppers to different products.
  • Check ranking: Synonyms can increase recall, but they do not guarantee that the most relevant product appears first. Review searchable attributes, custom ranking, business rules, and merchandising.
  • Account for plural and inflection handling: Confirm how the index handles singular and plural forms before adding redundant synonym records.
  • Consider localization: Synonyms may differ by country or language. Maintain separate lists when the same term has different meanings across markets.
  • Monitor after release: Measure no-result searches, click-through rate, conversion rate, and search refinement rate before and after the change.

A practical WooCommerce workflow

  1. Export or review the last several weeks of Algolia search analytics.
  2. Group failed or weak queries by likely intent rather than by spelling alone.
  3. Compare each group with the actual vocabulary in product titles and taxonomy terms.
  4. Add a small, targeted synonym set to staging.
  5. Test exact terms, multi-word queries, filters, facets, autocomplete, and mobile search.
  6. Deploy through the same configuration process used for the production index.
  7. Review performance and remove mappings that broaden results without improving engagement.

For WooCommerce teams, synonyms are often a low-risk way to improve search without re-importing products or changing the catalog structure. A focused set based on real shopper language can make existing inventory easier to find while leaving indexing and merchandising workflows intact.

Trending posts
You might also like