Diversification rules
The Diversification rule enables automatic reordering of products to ensure a balanced and varied product display, while preserving the overall ranking logic.
Overview
Diversification helps avoid repetitive product sequences (e.g. same brand or similar items) and improves product discovery without sacrificing performance.
Key benefits include:
Improved product discovery
Reduced visual repetition
Increased engagement and CTR
Maintained business control and performance

How it works
When applied, Diversification does the following:
Runs after all ranking and rules have been executed
Reorders products to maximize variation across selected attributes
Modifies display order only, scores remain unchanged
Where it applies
The Diversification rule is applied on the overall strategy, after all ranking and rules have been executed. This ensures global diversity across all combined rules.
Example: avoiding multiple products from the same brand across a full recommendation list.
Attribute support
Diversification can be configured on any product attribute available in the catalog, regardless of type:
String
brand , category , color
Numeric
price , rating , margin
Boolean
on_sale , new_arrival

Up to 3 attributes can be combined simultaneously.
Typical use cases
Common scenarios where diversification is useful include:
Avoiding showing multiple products from the same brand consecutively
Mixing different product types within a category (e.g. a skincare routine)
Balancing price ranges within a recommendation list
Alternating between promotional and full-price products
Last updated
Was this helpful?

