--- title: "Configure XRecommend Service" slug: "configure-xrecommend" updated: 2025-05-13T20:02:09Z published: 2025-05-13T20:02:09Z canonical: "docs.xgen.ai/configure-xrecommend" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xgen.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configure XRecommend Service > [!TIP] > Time Estimate > > 5 mins ## 1. In XGEN Platform ### Navigate to XRecommend [**Engines**](https://app.xgen.ai/xrecommend/models) 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**](https://app.xgen.ai/xrecommend/models/create?model_type=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**. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 1.41.01 PM.png) > [!NOTE] > 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 > [!NOTE] > 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. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/image(74).png) ### **Insert App Block** Click the “Add Section” button and select the Apps option. In that menu, select “XRecommend” as an option. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 1.55.57 PM.png) ### Paste **Experience ID** In the field at top of the page, please paste the XRecommend Experience ID you copied from the XGEN Platfom. ![](https://cdn.us.document360.io/ae46ce4b-af2c-4789-b3ad-1d1ccd16b4a1/Images/Documentation/Screenshot 2025-05-13 at 1.56.44 PM.png) Next, begin to [Customize XRecommend Widget](/v1/docs/customize-xrecommend)