XRecommend Experiences control API Element and Rendered Element settings. You can control the placement on the page, the recommendation type, optional product filters, and more.
Creating a New Experience
When creating a new experience, you have two options depending on your integration method
XGen Rendered: XGen will hold the code and logic to place this element on your site.
API Version: You will have complete control of the products that appear within the element and where it appears and how it is styled.
Both require a name to proceed to the next step.
Experience Settings
Experience Information
Element Name: The name of the element, e.g., “Tutorial Element"
Experience ID: Displays the unique identifier for the element. This ID cannot be edited after creation.
Notes: A text field for additional information about the element that helps contextualize it.
Triggers
Triggers help you set the conditions that initiate a recommendation experience. Triggers can be set by a Page Path or Query String with a set of 5 operators and a condition:
Equals
Doesn’t Equal
Contains
Doesn’t Contain
Matches Regex
Multiple triggers can be added.
Element Hook & Position
Paste the component ID in the text field and control the relative position: Above, Replace, and Below.
Recommendation Type
Available Recommendation Types
AI Model (Default)
Best Sellers
Most Viewed
Recently Purchased
Purchased With
Viewed With
Random
No Recommendations
Merchansdising Rule
Add Merchandising Rules that exist in the platform.
*Legacy Filters provides access to custom coded filters that persist after platform upgrades.
Max Recommendations
A field that governs the limit of recommendations that will be displayed in the experience.
Universal Pinned Products
Choose products that will be pinned at the beginning of this element's recommendation list. If a product from the 'Product Specific Pinning' is being viewed, Universal Pinning will not be applied. Reorder with drag-and-drop functionality to control the order of appearance.
Select Products to pin
After clicking the “Choose Products” card under the Universal Pinned Products section, you will see a modal that allows you to search your catalog and select products.
Product Pinning example with the term “Coats”
After products are selected you can close the modal and arrange the products as you see fit. The order represented in the settings pane will preview the sequence provided by the element.
Locale-specific product availability
Depending on the location of the user’s IP, the relevant locale will be called automatically. Stock quantity will effect the display of products depending on their location.
Product Specific Pinning
Choose products that will have specific pinning configurations when viewing their product display page (PDP). These settings will override 'Universal Pinned Products' when a product is being viewed.
Click the Add Association Button
Search a product code to find products you want to specifically associate other products with.
The same product pinning modal will appear once you select the “Choose Products” card as shown above for “Universal Pinned Products”
Preview Links
Preview your element on your site without publishing it.
Element Template
For XGen Rendered Elements, an template is necessary to power the element’s styling and behavior. The template page is not available for API Elements.
FAQ
Will the XGen Team create a new experience for our brand?
If you choose XGen Rendered experiences, we will work closely with your team to match your customer-facing brand styling across your website. If you choose the API Version, our team is available to support your developers with any questions during the integration process.
What is the purpose of triggers in the recommendation experience?
Triggers set the conditions that initiate a recommendation experience based on Page Path or Query String.
Can I customize the number of recommendations displayed?
Yes, you can set the maximum number of recommendations that will be displayed in the experience.
What is the difference between Universal Pinned Products and Product Specific Pinning?
Universal Pinned Products are pinned at the beginning of the recommendation list, while Product Specific Pinning overrides this for specific products when they are viewed.
Is it possible to preview the element before publishing it?
Yes, you can preview your element on your site privately, without publishing it.