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.
Before you begin: Choosing the right recommendations setupThis 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 ShopifyLoomi 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:
- Discovery is set as the destination for your item collections.
- 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.
-
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 | The widget ID, found in Bloomreach under Recommendations > Widget Configurator. |
| Category ID | (Category widget only) ID of the category the widget displays in the preview. |
| Items ID | (Items widget only) ID of the item for which the widget returns related items in the preview — for example, similar, co-viewed, or co-purchased products. |
| Keyword | (Keyword widget only) Keyword used to narrow items shown in the preview. |
| 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. |
| How many items to fetch | Define how many products are recommended in total. |
| 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. |
For numerical fields, always enter a whole number (for example,
4). Decimals and special characters aren't supported.
Supported fields
The following Solr field names are available for the Fields setting:
pidtitlesku_titlevariant_titlebrandpricethumb_imagevariantsskuidsku_color_groupsku_colorsku_swatch_imagessku_thumb_imagesurlsale_pricesku_sale_price