Configure Loomi Search+

This guide covers the process of configuring and applying Loomi Search+ via the dashboard for both global and query-level rules.

🌟

This is a Premium tier feature powered by Loomi AI.

Prerequisites

Knowledge

Review the following guides:

• Loomi Search+: This guide introduces you to Loomi Search+ and the key vector search concepts. The dashboard workflow is based on these concepts.
• Search control studio: This guide helps you get familiar with Search control studio. Loomi Search+ controls are part of the same application interface.

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 a Loomi Search+ setting.

Loomi Search+ overview

Navigation

Go to AI Studio > Search control studio in the Bloomreach dashboard. Here, you'll see the following tabs:

• Global rules: Use this section to turn on or off, edit, or preview global Loomi Search+ settings for your site.
• Query overrides: Use this section to change Loomi Search+ settings at the query level. Here you can view, add, edit, or delete query override rules for specific queries.

Global rules

Under the Global rules tab, view Loomi Search+ for all your language-specific catalogs in the account.

The Loomi Search+ column shows the setup status. Here is what each status means:

• Needs setup: The catalog doesn't have Loomi Search+ embeddings.
• Setup in progress: Loomi Search+ embedding generation is in progress.
• Off: Embeddings are available, but Loomi Search+ isn't applied.
• On: Loomi Search+ embeddings are available and applied.
• N/A: Loomi Search+ setup isn't available for the catalog.

Configure global Loomi Search+ rule

To configure a global rule for Loomi Search+ at the catalog level, follow these steps:

1. Start setup to generate embeddings

1. Under the Global rules tab, click the Edit button next to the global rule.

2. Click the Setup Loomi Search+ button.

   

3. Click Save to start the setup.

4. The Search control studio listing page shows the status: Setup in progress. The system is now generating embeddings, which typically takes about 48 hours to complete.

5. When embedding generation is complete, the status turns grey with the message Off. You can now apply Loomi Search+ to the results.

2. Apply Loomi Search+

1. Go to the global rule and click Edit.
2. The green status shows the message Ready. Toggle ON Loomi Search+.

3. Configure vector search precision

When you apply Loomi Search+, a Vector search precision section appears adjacent to the keyword search precision options. Vector search precision lets you adjust the precision level for vector search.

Static vector search precision

This applies a static, catalog-level cutoff for all queries to determine the recall. The following options are available:

• Standard: Default setting that maximizes recall and displays all related products.
• High: Displays a smaller, more precise product recall.

Dynamic vector cutoff (DVC)

Dynamic vector cutoff computes a query-specific cutoff in real time to determine the recall.

1. Click Setup dynamic vector cutoff to start model training.

   

2. The toggle reflects the current setup state:

   • Setup in progress: The system is training the Dynamic vector cutoff model. This can take up to 24–48 hours.

     

   • Ready: Setup is complete. The toggle is available to turn ON.

   • Setup failed: Setup was unsuccessful. Click Setup failed, retry to try again. If you encounter persistent issues, contact your Customer Success Manager (CSM).

3. Once the setup shows a green Ready status, toggle ON Dynamic vector cutoff.

   

   📘

   Note

   If you complete DVC setup but never enable it in any rule, or later toggle DVC OFF, the trained model remains available until the expiration date shown in the interface.

   During this period, you can enable DVC again without running the setup. After the expiration date, a new training cycle is required.

4. Choose the desired precision based on your goals:

   • Standard: Keeps an overall balance between recall and precision.
     • For clear, specific queries, keeps results focused and relevant.
     • For long-tail queries, relaxes the recall so shoppers can explore a broader range of relevant products.
   • High: Keeps results very precise, showing fewer products. Ideal for catalogs where noisy or off-brand results are a concern.
     • For broad or ambiguous queries (for example, "shoes" or "dress"), removes more irrelevant products.
     • For very specific or long-tail queries, keeps highly relevant products rather than expanding recall.
   • Managed by Bloomreach: This advanced read-only setting appears only in special use cases where Bloomreach manages the precision and recall balance on your behalf.

4. Preview search results

After applying Loomi Search+ and configuring vector search precision, use the Preview capability to compare how the results have changed.

📘

Note

If the Side-by-side preview shows little or no change for a query, this doesn't mean DVC isn't working. It may indicate that the static and dynamic cutoffs produced similar results for that specific query, or that the cutoff difference didn't change which products entered the recall.

5. Enable Loomi Search+ globally

Once you're satisfied with the results, click Save to enable Loomi Search+ for all queries. The Loomi Search+ status turns green with the message On.

A/B test global rules

A/B test via dashboard

Follow the A/B test instructions for global rules.

A/B test via API

Review the steps to run A/B tests via API. Check the Loomi Search+ API parameters.

Query overrides

There are use cases where you want to enable or disable Loomi Search+ for certain queries, or use a different level of vector search precision. For example, at the global level, you have Standard vector search precision, but you want the query "waterproof women's running shoes" to use High vector search precision for a more precise recall.

Query override rules let you accomplish this. Use the Query overrides tab to select the columns
to view for your query override rules.

Configure a query override rule for Loomi Search+

Prerequisites

Embeddings must already be generated and successfully indexed at the catalog level before you set up overrides at the query level.

1. Specify queries and rule influence

1. Click + New query override to open the New query override page.

   

2. In the Queries field, enter the query for the rule. To specify multiple queries, press Enter/Return after each query.

3. Select the catalog Influence for the override rule from the dropdown. The Associated sites section shows which sites use this catalog and will be affected by the rule. If you have multiple catalogs, specify the catalog to target. For a Loomi Search+ override, you must choose a catalog.

2. Change query-specific Loomi Search+ settings

Select the appropriate Loomi Search+ setting. You can select a different vector search precision, dynamic vector cutoff override for the query, enable Loomi Search+, or disable it altogether for the selected queries.

3. Preview results and save the override

1. Click Preview to view the product search results for this query override rule.
2. If the results look correct, click Save.

A/B test query overrides

Follow the A/B test instructions for query overrides.

Manage existing Loomi Search+ rules

Edit a Loomi Search+ rule

1. Go to the global or query override rule you want to modify and click Edit on the Search control studio page.
2. Select the appropriate Loomi Search+ settings (as illustrated above).
3. Preview the results to see changes.
4. Click Save.

Delete a Loomi Search+ query override

Go to the override rule you want to delete and click the dropdown next to the Edit button. Select Delete to delete the rule.

Conflict resolution

Review the conflict resolution order.

Debug issues

I'm unable to apply Loomi Search+ after starting the setup. What can be the issue?

Loomi Search+ results may not be available if embedding generation is still in progress. Check back 48 hours after you enabled the embedding generation.

You can monitor the status messages on the Search control studio listing page under the Loomi Search+ column:

• Setup in progress: Loomi Search+ embedding generation is in progress.

• Off: Embeddings are ready after 48 hours. You can now apply Loomi Search+.

  If the issue persists, contact your Bloomreach representative.

How can I understand whether Loomi Search+ is enabled for a given query?

Use Product grid insights to understand whether Loomi Search+ is being used for a query or a catalog. The interface also distinctly shows the products matched by the keyword search and those retrieved by the vector search.