Skip to main content

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.

​
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 lifted its score. The badge shows the lift as a percentage of the base value (for example, +18%) so you can see how much each match was boosted relative to its starting score. Products that match a soft boost but receive no lift (the base score was already at or above the target) display the badge without a percentage.
  • Boosted image overlay — a small Boosted badge appears on the product image when at least one soft boost matched. Use it to quickly spot which products in the grid were lifted.
  • 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 +N% lift across products to gauge the effect. If the lift is small or zero on products you expect to boost, raise Boost Strength or the Percentile Target.
  • 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.