Fix unexpected search results - Layers

Most search problems have a specific tool that fixes them. Find your symptom below, make the change, then check the result with Search preview before shoppers see it.

Symptoms and fixes

Symptom	What to check	Tool
Searching a SKU, style number, or barcode returns nothing or the wrong product	The field holding the code is searchable, with enough keyword weight for exact matches to win	Attribute options, Searching on variant barcodes
A product’s exact name doesn’t come first	Keyword matching carries enough weight against AI matching for this kind of query	Tune signal weights
One query, such as “clearance” or “gift”, should show a specific set of products	A ranking rule scoped to that query that filters, pins, or boosts the right products	Create a ranking rule
Results ignore store-wide guidance, such as “favor core styles over accessories”	Guidance written once for every AI step	Search instructions
A query should open a collection or page instead of results	A redirect for queries with that meaning	Semantic redirects
Products or pages that shouldn’t be searchable appear	A hidden content rule or an excluded tag	Hidden products, Search excluded tags
Sold-out products crowd the top	Out-of-stock visibility and demotion	Out-of-stock product visibility
Too many loosely related products appear	How strictly Layers filters out low-relevance results	Result relevancy filtering

Before you change anything

Reproduce the query. Run it in Search preview and note which products appear and in what order.
Check the product data. If a product doesn’t contain the words shoppers use, no setting can match it. Add the terms to its title, description, tags, or a searchable metafield.
Change one thing at a time. Rules, weights, and instructions interact. Make one change, preview, then decide on the next.

Next steps

Ranking and relevancy
Configure search behavior
Contact support if a query still returns the wrong products