bluebarry.
ReviewsPricingResources
Sign inBook demoBook a 15 min demo
Help Center/Search/Tune search matching

Tune search matching

Martijn Douma
Martijn Douma · Co-founder bluebarry
Updated September 25, 2026

Matching decides which products come back for a search at all. Get it right and shoppers find the moisturizer whether they type “moisturiser”, “face cream” or a brand name. Which of those products come first is a separate choice, covered in personalize search results.

Open your configuration under Merchandising → Search, stay on Configure and choose Matching. Changes save automatically. Check them on the Preview step.

The Matching section with match sensitivity set to Balanced, Match by meaning switched on, and the searchable attributes table

Match sensitivity

Sensitivity sets how closely a product must match before it appears. It controls typo tolerance and how much of the whole search has to match. Products below the line are left out of both the results and the filters.

Sensitivity levels
LevelOverall match neededGood for
LooseAt least 20%Small catalogs, and shoppers who make lots of typos
BalancedAt least 30%Most stores. The default
FocusedAt least 40%Large catalogs with many similar names
StrictAt least 50%Parts and article numbers, where a near miss is the wrong product
Very strictAt least 60%Only close matches, with little typo tolerance

A simple rule: if shoppers see products that have nothing to do with their search, move one step stricter. If obvious typos find nothing, move one step looser.

Match by meaning

Under Understand intent, switch on Match by meaningto also find products by what a search means, not just the words in it. A search like “something for dry lips at night” can then find an overnight lip mask, even when no product uses those words.

Keyword matches still come first. Products with a related meaning fill in below and around them. After you switch it on, bluebarry prepares your catalog in the background and shows progress, for example “1,200 of 1,500 products indexed”. It starts within a minute, and new or changed products are picked up automatically.

Searchable attributes

The attributes table decides where search looks and how much each match counts. The product name is always searched. Use Search attributes… above the table to find an attribute quickly.

Columns in the searchable attributes table
ColumnWhat it does
Shopper labelThe name shoppers see in filters and the product comparison. Leave it empty to use the property name.
SearchableSearch looks inside this attribute. Switch it on for things shoppers type, like brand, category, color or key ingredient.
Exact matchFor identifiers like a SKU or article number. Matches the exact text or its start, without typo tolerance.
Open directlyWhen a search equals one product's value, that product page opens instead of a result list. Needs Exact match.
Auto-filterWhen a search contains one of this attribute's values, results narrow to it: “le creuset pan” shows only Le Creuset pans. Text and list attributes only.
WeightHow strongly a match here counts. 1 is normal. Raise it for attributes that say a lot, like brand, and lower it for noisy ones.

Keep it focused. Making every attribute searchable adds noise, because a search for “rose” will also match every product with rose somewhere in a long list of tags. Start with what shoppers actually type and add more when your analytics show a gap.

Synonyms

Synonyms connect the words shoppers use to the words in your catalog, so “couch” also finds your sofas.

Add synonyms yourself

  1. Click Add synonyms.
  2. Under Terms, enter two or more words that should find each other, like sofa, couch and settee.
  3. Choose a Direction. Both directions means every term finds the others. First term only means the first term finds the rest, but not the reverse. Use it for broad words: with “makeup, foundation, concealer”, a search for makeup finds both, but a search for foundation does not show concealers.
  4. Click Add synonyms to save. Edit or delete a group from its row later.

Let bluebarry suggest synonyms

Click Suggest synonyms. bluebarry reads your catalog and proposes groups, each with a short reason. Click Accept on the ones that fit, or use Accept all and Dismiss all. Nothing is added until you accept it.

The Synonyms card with suggested synonym groups, each with a reason and an Accept button

Import synonyms from a CSV file

Already have a synonym list? Click Import CSV. Put one group per row, 2 to 10 terms separated by commas, without a header row. Every row is imported as Both directions.

sofa,couch,settee
moisturizer,moisturiser,face cream

A configuration holds up to 200 synonym groups. Terms can be up to three words long. Rows with fewer than two terms or a longer term are skipped, and the import tells you what it skipped.

Catalog scope

Catalog scope limits which products this configuration can return at all, for example only products in stock, or everything except samples.

  1. Pick an attribute, a condition such as equals, is not or greater than, and a value.
  2. Click Add. The condition appears under Active conditions.
  3. Check Matching products below. It shows a sample of what search can return, and warns you when no product matches.

A product that matches any one condition is included. With no conditions, search can return your whole active catalog.

Good to know

  • The Practical starting point sets sensitivity to Strict and Lifestyle to Balanced. Change it any time.
  • The best source for new synonyms is your own shoppers. The Zero-result searches list on the Analyze step shows what they typed and did not find. See read search analytics.
  • When a search should open a page rather than show products, like “returns”, use a redirect instead of a synonym. See add redirects, banners and quiz triggers.
  • Which attributes appear as filters is set under Results & Filters. See configure search results and filters.

Related articles

Set up search

Add a search configuration, walk through the guided setup from Start to Preview, check it on your own store, and re-run or duplicate it later.

Read article →

Configure search results and filters

Choose what the search dropdown shows, how the results page loads more products, and which filters and comparison attributes shoppers get.

Read article →

Add redirects, banners and quiz triggers

Show best sellers before shoppers type, help when nothing matches, and add redirects, quiz triggers, banners and collection suggestions to search.

Read article →

Read search analytics

Understand each search metric, fix searches that find nothing with synonyms and redirects, spot your top searches, and measure your segment rules.

Read article →

Can’t figure it out? We probably can.

Every article here was written by the people who built the product. If one of them still leaves you stuck, tell us and we’ll fix it.

Contact usJoin Discord, free forever
bluebarry.

Helping beauty, health and outdoor brands reach their dream AOV

[email protected]+31 6 57 16 10 87De Ried 10, 9285KK Buitenpost (The Netherlands)
Martijn DoumaStan van RooyAnco PostmaJelmer Reitsma

The guys that are increasing your AOV.

Platform
Quiz funnelsLanding pagesProduct QuizRecommendationsSearchIntegrationsPricing
Resources
CasesHelp centerFAQCompare
Company
Contact usPartners & affiliateReviewsRequest demo
Book a 15 min demo
© 2026 bluebarry. All rights reserved.
Privacy PolicyCookie PolicyTerms & Conditions
English/Deutsch
bluebarry