Skip to main content

​
Steps

  1. Go to Sort Orders and select a sort order.
  2. Use Preview to see how a collection will look.
  3. Review the sort effect annotations on each product to understand why it appears where it does.
  4. Adjust settings if something doesn’t look right.
  5. Save changes when you’re happy.

​
Sort effect annotations

The preview panel shows annotations on each product so you can see exactly which sorting rules affected its position. Each annotation corresponds to an expression in your sort order configuration.

​
What you’ll see

  • Promoted by #N (green badge) — a priority rule in position N promoted this product toward the top of results.
  • Demoted by #N (red badge) — a priority rule in position N demoted this product toward the bottom of results.
  • Soft Boost #N (blue badge) — a soft boost expression in position N matched this product and adjusted its score. The badge also shows the computed boost value.
  • Metric values — when your sort order includes a metric or numeric attribute, the actual value used for sorting appears next to each product. Hover over the value to see which metric it belongs to.
The position number (#N) refers to the expression’s order in your sort order configuration, starting from 1. This makes it easy to trace each annotation back to the rule that caused it.

​
How to use annotations

  • Verify priority rules: Confirm that the correct products show a “Promoted” or “Demoted” badge for each rule.
  • Tune soft boosts: Check that soft boost badges appear on the expected products and compare the boost values across products to gauge the effect.
  • Debug unexpected ordering: If a product appears higher or lower than expected, its annotations reveal which expressions influenced its position.
Hover over metric values and badges to see a tooltip with the full label of the sorting expression. This is especially helpful when your sort order has multiple metrics or rules.