Search control studio

This guide provides an overview of the Search control studio application.

What is Search control studio

Search control studio allows you to preview, edit, and save algorithm settings.

Prerequisites

Permissions
Ensure that you have the Recall and ranking studio editor permission. Your Users admin can assign this role to any user who wants to create or edit an algorithm setting.

Navigate Search control studio

Navigation: Go to AI Studio > Search control studio in the Bloomreach dashboard.

The Search control studio page shows the following tabs:

  1. Global rules: Use this section to turn on or off, edit, or preview global algorithm settings for your site. For example, use global rules to turn on precision mode for your entire site.
  2. Query overrides: Use this section to change algorithm settings at a per-query level. View, add, edit, or delete query override rules for specific queries. For example, use query overrides to remove precision mode for specific queries where the default algorithm provides a better experience.
📘

Note

When you enter Search control studio at the account level, you can only apply settings at the account or language-specific catalog level, based on your account setup. If you enter at the site level, you can only apply settings at the site level.

Search options

The following search options are available in the Search control studio. Visit the respective pages to learn more about each setting.

Language support

Some algorithm settings are only available for English sites and aren't applicable to non-English sites. The following table summarizes language support for each algorithm:

AlgorithmLanguages supported
Keyword search recall precisionText match: all languages.
Product type precision: all languages.
Category precision: all languages.
LLM-based precision: English only.
Query relaxationQuery relaxation to product type: all languages.
Facet precisionStandard facet precision: English, French, and German only. High facet precision: English, French, and German only.
Spell correctAll languages.

If an algorithm isn't supported for a particular language, it won't appear in the dropdown options. For example, if your account has both an English and a French catalog, the values for the English catalog (Homeoasis_EN) and French catalog (Homeoasis_FR) for search recall precision will differ, since product type precision isn't supported for French language catalogs.

Keyword recall default modes

The following table shows the default mode for each keyword recall algorithm:

AlgorithmDefault mode
Search recall precisionText match precision
Query relaxationProduct type
Facet precisionStandard
Spell correctTerm frequency

A/B test options

Use the External A/B test for both global rules and query-specific rules to run side-by-side comparisons of search configurations using the dashboard or the front-end API call.

Conflict resolution

Suppose a setting is passed at various levels — the dashboard and the API. Priority order works as follows:

  1. Query override on the dashboard.
  2. API parameters passed directly on the front-end API call.
  3. Bloomreach backend test for any live A/B test.
  4. Global rules on the dashboard.

Example: Global rules are set up on the dashboard for search recall precision as text match.

Case 1: You are running a live A/B test with a 50/50 traffic split for text match and category precision. Because the Bloomreach backend test has a higher priority than global rules, the CMS setting takes precedence, and 50% of traffic uses text match precision while the other 50% uses category precision.

Case 2: On top of case 1, you are also controlling the feature for a few search queries by passing search recall precision as product type precision. In this case, product type precision applies to the queries you control. For all other queries, the Bloomreach backend test (live A/B test) is respected.

Case 3: On top of cases 1 and 2, you have a query override set up for search recall precision as category precision for a few queries. Because query overrides have higher priority, those queries use category precision. For the queries you control directly, product type precision applies. For all other queries, the Bloomreach backend test (live A/B test) is respected.

Search control studio FAQs

Do all settings need to be updated together on the dashboard?

No. If you want to update or preview one setting at a time, select the relevant dropdown value for that setting and leave all other settings as they are.


© Bloomreach, Inc. All rights reserved.