This guide outlines how to create, configure, and preview a product recommender, including defining rules, filters, slot logic, and ranking behavior.
🧠 Creating a New Recommender
To create a recommender, follow these steps:
Navigate to Experience > Recommenders.
Click "Add Product Recommender" to open the recommender builder.
Give your recommender a title in the Recommender Name field.
Define how many products the recommender will display in the Max Recommended Products field.
You can increase or decrease this using the input field or arrows, or by typing a number in the field.
⚙️ Recommender Configuration
To define which products should be included in the recommender, click on Addrule. This will open the rule setup panel.
Rule Title
Give your rule a descriptive name to clarify its purpose. This is especially useful when using multiple rules.
Slot Allocation per Rule (Max Slots)
Here you can define how many of the allotted slots this rule should account for. There are two use cases on how to set this up:
Full Slot Allocation: Keep the slot number the same as in the Setup page. All the available slots will be filled by this rule, unless there are not enough products to fulfill this (for example if the recommender should show 10 products, but only 6 match the criteria). In this use case, we recommend setting up a secondary fallback rule with less conditions to make sure the recommender displays the correct number of products.
Partial Slot Allocation: Set a custom slot limit for the rule (e.g., 5 out of 10 total). Use this to split recommendations across different rule types (for example to recommend different types of products).
Define the Recommendation Criteria (Product Recommendation Filter)
You can define criteria for products to be included in the recommender. You can filter products based on attributes by using Conditions (for example, "Product Category [equal to] Apparel").
To apply multiple filters at the same time, add a Condition Group instead.
Dynamic Condition Matching
For more dynamic recommendations, you can select the “Same as product on page” option when adding a value to the selected condition.
As an example, if you’d like to recommend products of a similar colour as the one displayed on the Product Detail Page the recommender is shown on, this is the condition that should be applied: Product Colour [equal to] Same as product on page.
Ranking Points - Manual Points
You can add ranking points to prioritise specific products. Click Add Ranking Rule to create a ranking-based prioritisation and define the weight of points, as well as the condition(s) required for a product to receive the points.
For example:
Set the condition (e.g., Product Category [equal to] Sneakers)
Assign points (e.g., 5 points)
Products meeting this rule will be prioritised in display order.
Ranking Points - Mapped Points
You can also use Mapped ranking points. To do so, you will need to create a product property with the points you’d like to assign, and then assign points to products by adding a corresponding value for each product. This can be added to your own product feed, or you can use Crobox’s built-in solutions (ideal for a smaller amount of products).
You can find guides on how to create a Property, and how to use Product Data Enrichment below:CommentShare feedback on the editor
To determine how products are ordered within the recommender, click on Add sorting rule. You can then select an attribute to sort on, for example "Product Ranking Points" or “Product Property Price”, and choose between High to Low or Low to High for the order.
Rule Preview
Click "Preview" to see which products will be recommended based on the specific rule set.
🔧 Managing Multiple Rules & Preview
You can add multiple rules to a single recommender, either to act as fallback rules in case the first rule cannot fill all the slots, or to show different recommendation sets (see Slot Allocation per Rule section).
You can create a new rule from scratch, or click on the three-dot menu next to an existing rule to Duplicate and adjust.
Use the "Move Slot Up/Down" buttons to rearrange rule order, which you can find by clicking on the three dot menu next to a rule.
To see which products are recommended based on all the rules you set up, click on the Preview button at the bottom of the page. Keep in mind that you first need to save any changes made to the rules for the preview to be accurate.