Search Configuration

Fine-tune how search works for your store. All settings are in the app dashboard under Search > Configuration.

Searchable Attributes

Control which product fields are searched and their relative importance.

Adjusting Field Weights

Navigate to Search > Configuration > Searchable Attributes to see the list of indexed fields. Drag fields up or down to change their priority:

Fields higher in the list are given more weight in search results
Moving "Product title" to the top means title matches rank highest
You can disable fields by toggling them off (they remain indexed but are not searched)

Adding Metafield Search

To make product metafields searchable:

Go to Search > Configuration > Metafields
Click Add metafield
Select the metafield namespace and key
Set the weight (position in the attribute list)
Click Save

Common metafields to add:

Custom material/fabric fields
Brand-specific attributes
Technical specifications

Autocomplete Settings

Suggestion Count

Product suggestions: 1-10 (default: 5)
Query suggestions: 0-5 (default: 3)

Debounce Time

The delay between the shopper's last keystroke and the autocomplete request:

Default: 150ms
Range: 50ms - 500ms
Lower values feel more responsive but generate more requests

Minimum Characters

The minimum number of characters before autocomplete activates:

Default: 2
Range: 1-5

Typo Tolerance

Enabling/Disabling

Typo tolerance is enabled by default. To disable it:

Go to Search > Configuration > Typo Tolerance
Toggle Enable typo tolerance off

You can disable typo tolerance for specific attributes. This is useful for:

SKU fields (where exact matches are important)
Size fields (where "S" and "M" are distinct, not typos)

"No Results" Behavior

When a search returns zero results, you can configure the fallback:

Show popular products (default) — Display your store's best-selling products
Show related suggestions — Suggest alternative search terms
Custom message — Display a custom message with a link to browse collections
Combination — Show suggestions AND popular products

Configure this in Search > Configuration > No Results Behavior.

Search Within Collection

Enable shoppers to search within a specific collection:

Go to Search > Configuration > Search Scope
Toggle Enable search within collection on

When enabled, collection pages show a search bar that filters results within that collection only.

Synonym Management

Adding Synonyms

Go to Search > Synonyms
Click Add synonym pair
Enter the two terms (e.g., "hoodie" and "sweatshirt")
Click Save

One-Way Synonyms

One-way synonyms ensure that searching for term A also returns results for term B, but not vice versa:

Example: Searching "iPhone" also returns "phone case" results
But searching "phone case" does NOT return "iPhone" results

Importing Synonyms

For stores with many synonyms, you can import a CSV file:

Go to Search > Synonyms
Click Import CSV
Upload a CSV with two columns: term_a and term_b