Loomi AI for Shopify Recommendations

Loomi AI for Shopify recommendations adds product recommendation widgets to your storefront, helping you drive more sales with personalized suggestions tailored to each shopper. This guide walks you through installing the required apps, adding a widget to your theme, and configuring its settings.

🛑
Choosing the right recommendations setup
This article is for Bloomreach Search customers setting up recommendations directly on the Shopify storefront. If you use Bloomreach Marketing Automation, recommendations are configured from the Bloomreach platform instead — see Loomi AI for Shopify personalization features.

Prerequisites

Before you set up Recommendations, make sure you've completed the following steps:

Install Loomi AI for Shopify from the Shopify App Store.
Install the Discovery connector from the Shopify App Store.

📘
Applies to Loomi AI for Shopify
Currently, Loomi AI for Shopify requires the Discovery V2 application to enable recommendation. In a future release, it will be built into Loomi AI for Shopify, so this installation step won't be needed.

Complete the integration and sync your data with Bloomreach. For the integration settings in Data hub, ensure that:
1. Discovery is set as the destination for your item collections.
2. The following web events are tracked: widget_view, widget_click.
Enable the Bloomreach Web SDK.
Create a widget in Discovery > Recommendations > New widget and save the widget ID.

Add the Recommendations widget

In your Shopify admin, go to Online Store > Themes > Edit theme.
Choose a section, click + Add Block, and from the Apps tab, add Bloomreach [widget type] Widget to your theme.
In the widget details panel, configure the [Recommendations settings](#configure-recommendations-settings).
Click Save.

Configure Recommendations settings

After adding the widget to your template, configure the following settings in the Loomi AI for Shopify app:

Setting	Description
Title	Title of the page section containing the widget.
Widget	ID of the widget created in Bloomreach under Recommendations > Widget Configurator > first column in the widgets overview table.
Category ID	(Category widget only) Limits the widget to items in this category.
Items ID	(Items widget only) Returns related items — for example, similar, co-viewed, or co-purchased products.
Keyword	(Keyword widget only) Limits the widget to items matching this keyword.
Endpoint	Choose whether search requests go to your Staging (test) or Production (live) Bloomreach environment.
Fields	Specify which product attributes the API returns, using comma-separated Solr field names. See Supported fields.
How many items to show	Define how many products appear in the widget. Enter a whole number (for example, `4`). Decimals and special characters aren't supported.
How many items to fetch	Define how many products are recommended in total. Enter a whole number (for example, `16`). Decimals and special characters aren't supported.
Custom CSS	Apply custom CSS to style the widget without modifying your theme's core code. See the CSS class reference.
Additional parameters	Append extra query parameters to every API call for advanced behaviors such as views, segments, or experiments.

Click Save to apply your settings.

Supported fields

The following Solr field names are available for the Fields setting:

pid
title
sku_title
variant_title
brand
price
thumb_image
variants
skuid
sku_color_group
sku_color
sku_swatch_images
sku_thumb_images
url
sale_price
sku_sale_price

Choosing the right recommendations setup

Prerequisites

Applies to Loomi AI for Shopify

Add the Recommendations widget

Configure Recommendations settings

Supported fields

Related articles