Configure XRecommend Service

Time Estimate

5 mins

1. In XGEN Platform

Navigate to XRecommend Engines

Create a New Engine

1. Name your engine in the top left of the page by clicking on the pencil edit icon

2. Select DeepRec as your model type

3. Select "Default" under Locale Training

4. Deselect “Average Order Value” Goal for initial setup.

5. Click Save and Train.

Tips

For simplicity, do not alter any other controls with the DeepRec settings or select the QuickRec option. QuickRec is a fallback for our engine to maintain uptime and shouldn’t be used to drive your core experience.

Navigate to XRecommend Experiences

1. Create a New Experience.

2. Select “API Version” in the modal

3. Name your experience

Tip

Use a naming convention like Audience/Placement (e.g., "Homepage - Trending Now" or "Collection Page - Sustainable Products").

1. Set the Experience Title: This is the customer-facing title that may appear in APIs or debugging tools. Set it to something simple and clear.

2. Choose a Recommendation Type

   1. AI Model: for machine-learning powered recommendations

   2. Best Sellers

   3. Most Viewed

   4. Recently Viewed

   5. Purchased With Viewed With Random

   6. No Recommendations: Best for items you want to explicitly dictate products for using the “Pin”

3. Choose a Product Filter

   Under Product Filter, choose a saved Merchandising Rule if you want to narrow recommendations to a certain category, tag, or attribute. If no filter is selected, the experience will pull from your full catalog.

4. Set Max Recommendations

   In the Max Recommendations field, define how many products you want to return. Most carousels and widgets perform best with 4–12 products.

5. Set Universal Pinned Products (Optional)

   Click Choose Products to select specific items that should always appear first in the recommendation carousel. This is useful for promoting bestsellers, new arrivals, or seasonal products.

6. Configure Product-Specific Pinning (Optional)

   Use Product Specific Pinning if you want different pinned items depending on which product page the shopper is on. Click Add Association to define specific pinning rules and select specific products.

7. Save and Review the Experience ID

   Once you create the experience, the Experience ID is auto-generated.

8. Copy your Experience ID

   This ID is important — you’ll paste it into Shopify when configuring the widget.

2. In Shopify Theme Editor

Open Theme Editor

In your Shopify Admin dashboard, choose a theme to customize. It can be your public theme or an archived one.

Open Product Page

In the top menu of your theme, select Products, and a Product Page.

Insert App Block

Click the “Add Section” button and select the Apps option. In that menu, select “XRecommend” as an option.

Paste Experience ID

In the field at top of the page, please paste the XRecommend Experience ID you copied from the XGEN Platfom.

Next, begin to Customize XRecommend Widget