Skip to main content
Configure Search Behavior

Steps

  1. Open Settings → Search Behavior.
  2. Choose language, product visibility (e.g., hide out of stock), and image search preferences.
  3. Configure custom search excluded tags (optional).
  4. Adjust search tuning parameters for text, image, similar products, and content search (optional).
  5. Save changes and, if prompted, run a quick sync.

Search Excluded Tags

You can configure custom product tags that exclude products from the searchable database entirely. Products with any of these tags will not appear in search results. To add custom excluded tags:
  1. In the Search Excluded Tags section, enter a tag name in the input field.
  2. Click Add or press Enter to add the tag to the list.
  3. To remove a tag, click the X button next to it.
  4. Save your changes.
Note: Custom excluded tags are in addition to the default excluded tags (hide, algolia-ignore, layers-ignore). Tag matching is case-sensitive. Products with newly excluded tags won’t be removed from search until they’re re-indexed via webhook or bulk operation.

Search Tuning

The Search Behavior settings include advanced tuning parameters for different search types. These parameters control how search results are ranked and filtered.

Content Search Tab

The Content Search tab allows you to configure how article and content searches behave:
  • Text Weight: Controls the importance of text content similarity (0-1). Higher values prioritize matches based on article text, title, author, and tags. Default: 0.7
  • Image Weight: Controls the importance of visual similarity (0-1). Higher values prioritize matches based on article images. Default: 0.3
  • Top K Factor: Multiplier for candidate retrieval (1-20). Higher values fetch more candidates before scoring, improving recall but increasing processing time. Default: 3
  • Minimum Match Score: Minimum similarity threshold (0-1). Results below this score are excluded from results. Default: 0.0
These parameters allow you to fine-tune content search to match your store’s needs. For example, if your articles are primarily text-based, you might increase the Text Weight and decrease the Image Weight.

Tip

  • After changes, use Evaluate to test a few searches.