QSortby Guide
Personalization

Why this order — and tracing a shopper through your rule

The real ranker's order for one shopper group, with the arithmetic that produced it; and a made-up shopper with a history you can walk through the rule, so you can check a group no real visitor has reached yet.

Last updated · Nov 7, 2026

Personalization is a glass box: the rule is yours to read, and so is the order it produces. Two tools in the rule editor make that concrete, and both run the real ranker — the same function the storefront calls. Nothing is re-ranked in the browser, because a glass box showing the wrong insides is worse than no glass box.

Why this order

Open it from the rule editor, pick a group, and the page shows the order that group would be served, product by product, with a per-signal breakdown: what each priority contributed to each product’s score. A product leading because Top sellers carried it reads differently from one leading on Session intent, and the breakdown is where you see which.

Three things about it are deliberate:

  • You can inspect a group that matches nobody yet. It is the group most worth checking — and the one no real visitor could ever show you.
  • When the server sends no breakdown, none is drawn. A wrong order gets noticed; an invented explanation gets believed.
  • The shopper is invented, and printed on the page. An answer about a made-up person is only honest if the person is shown.

Trace this shopper

The rule editor’s Trace this shopper panel is the same idea walked step by step. Fill in a few facts — purchase count, days since last visit, visits, cart size, cart value — and the trace shows which group those facts land in, condition by condition, and the top products that group would see.

The made-up shopper also gets a history built from their numbers: products viewed, clicked, carted and bought, picked from your own catalogue. That history is what makes the trace useful. Without it every group previewed the same best-seller order, because Recently viewed, Cart history and Repeat purchase had nothing to work with; with it, a Cart abandoner’s cart products rank first and a Returning visitor’s order differs from a New visitor’s the way the two formulas say it should.

A first visit with an empty cart has no history to build, so it gets the best-seller order — and the page says why, rather than pretending to personalize nothing.

See the full order

See the full order opens the Why-this-order page for the same shopper, carrying the facts and the history across. Switching group there drops them, because a different group is a different person.

Menus are tucked away for bigger images — hover the edges to peek them, or Focus to pin. Click any image to zoom.

Popular

Set up QSortby — two steps Getting started Auto-sort a collection Auto-sort Create a personalization rule Personalization Upsell offers — the six touch points Upsell Troubleshooting Help
↑↓ to navigate ↵ to open esc to close