In addition to standard priority rule expressions that push matching products to the top of a collection, merchandising rules support soft boost expressions. Soft boosts apply a decaying multiplier to gently blend matching products higher in the sort order, creating natural interleaving rather than hard grouping.Documentation Index
Fetch the complete documentation index at: https://docs.uselayers.com/llms.txt
Use this file to discover all available pages before exploring further.
Soft boost in merchandising works the same way as Soft Boost in Sort Orders, but is scoped to a specific merchandising rule instead of applying globally. This lets you boost products contextually — for example, boosting “sale” items only for visitors from a specific campaign.
How soft boost expressions work
When you create an expression in the merchandising rule builder, you can choose between two expression types:- Priority Rule (default): Pushes all matching products to the top of the sort order as a group.
- Soft Boost: Applies a decaying boost that naturally interleaves matching products throughout the results based on their existing sort performance.
Boost modes
Soft boost expressions support two modes: Multiplicative (default) amplifies products that already perform well on the base sort metric. The existing sort value is scaled by a decaying boost factor, so products with higher base values receive a proportionally smaller lift. Best for promoting products that are already performing and have non-zero metric values. Additive (percentile-based) lifts matching products in value space toward a target derived from the rest of the catalog, boosting them even when they have zero or near-zero base values. Best for sprinkling in products that may not have metric data yet — like new arrivals, recently restocked items, or products in a new category.Configuration parameters
| Parameter | Mode | Description |
|---|---|---|
| Boost Strength | Both | In multiplicative mode, the amplitude of the boost multiplier. In additive mode, the fraction of the gap between a product’s base score and the percentile target that gets closed (0 = no lift, 1 = pulls exactly to target, > 1 = overshoot). Range: 0–10. Default: 0.25. |
| Percentile Target | Additive | The target value for matched products, expressed as a percentile of the base metric across the candidate set. Higher percentiles place matches further up the ranking. Range: 0–100%. Default: 50%. |
| Decay Rate | Multiplicative | Controls how quickly the multiplicative boost fades as the base score rises. Lower values produce more aggressive interleaving; higher values keep the lift longer. Range: 1+. Default: 100. Not used in additive mode. |
Additive mode was rewritten on 2026-05-02 to lift products in value space (a percentile of the base metric) instead of by row position. Boost Strength is now used in additive mode to control how much of the gap to the target is closed. Existing additive merchandising rules continue to work, but you may need to retune Boost Strength and Percentile Target to match the new behavior.
When to use soft boost vs. priority rules
| Scenario | Recommended Type |
|---|---|
| Feature a seasonal tag across the entire collection | Priority Rule |
| Gently promote new arrivals without displacing best sellers | Soft Boost (Additive) |
| Amplify high-performing sale items during a campaign | Soft Boost (Multiplicative) |
| Group products by category or brand at the top | Priority Rule |
| Sprinkle restocked items throughout a best-selling sort | Soft Boost (Additive) |
Soft boost expressions support the same targeting conditions as priority rule expressions. You can combine contextual conditions (geo, device, customer segment) with soft boosts for precise audience targeting.