Widget Setup

App Embed (Recommended)

The simplest way to add recommendations is via the Shopify app embed:

1. Go to Online Store → Themes → Customize.
2. Click App embeds in the left sidebar.
3. Toggle on SimplerSuite Recommendations.
4. Save.

The embed automatically injects the widget script on all pages. Widget placements configured in the dashboard will render in the appropriate locations.

Manual Installation

If you need more control over placement, you can add the widget manually using a Liquid snippet:

<div
  data-simplersuite-recommendations
  data-placement="product-page"
  data-product-id="{{ product.id }}"
  data-limit="8"
></div>

Data Attributes

Attribute	Required	Description
data-simplersuite-recommendations	Yes	Marks the element as a widget mount point
data-placement	Yes	Widget placement: product-page, cart, collection, home, post-purchase
data-product-id	Conditional	Required for product-page placement. The Shopify product ID.
data-collection-id	Conditional	Required for collection placement. The Shopify collection ID.
data-limit	No	Number of products to show (default: 8)
data-strategy	No	Override the strategy: bought-together, similar, trending, personalized

Verifying the Widget

After setup, visit a page where you’ve configured a placement. Open your browser’s developer tools and check:

1. The widget container is present in the DOM.
2. Network requests to the recommendations API return 200.
3. Product cards render inside the container.