QSortby Guide
DOCUMENTATION

How can we help?

Set up QSortby, learn how every recipe, rule and offer works, and get answers from the team that built it.

TroubleshootingThe four things that go wrong most often, and the fix for each. GlossaryEvery term the app uses — surface, recipe, slot, influenced revenue — in the app's own words. Contact supportEmail the team — we reply within one business day.

Getting started

6 guides

Auto-sort

9 guides
Auto-sort a collection Turn a collection you already have into one that sorts itself — pick a recipe, QSortby snapshots the current order, writes the new one to Shopify and keeps it fresh. Or let the app build a collection from scratch. The six recipes A recipe is a ranking formula with a name. Six are offered when you auto-sort — Best selling, Trending now, New & selling, Profit first, Personalized and Write your own — and this is what each one means, and what it needs. Set the time window & keep it fresh Choose which period the ranking looks at (rolling, period, or snapshot) and how often QSortby re-sorts and pushes the collection to Shopify. Test mode & preview — look before anything goes live Preview is a dry run you look at once. Test mode is a state: QSortby keeps computing the order without publishing it, and can show it in your own theme through a temporary preview collection that deletes itself. Snapshots & restore — undo is a feature Every sort saves the exact order it produced, including the order before QSortby touched the collection. Compare any two, and restore one to your live storefront in a sentence that says plainly what it does. The Products tab — find what a collection should be sorted by Every product QSortby tracks, with the numbers it ranks by. Best seller and climbing this week are different questions; this table is where you tell them apart before committing a collection to one. One product: what it sells with, and why The five tabs on a product — what shoppers actually did with it, what you configured, and the signals behind every similar-product match. Manage your collections Read collection statuses at a glance, filter by source or state, apply one recipe to a batch of collections, bring in Shopify collections, and pause or resume auto-sorting. Theme blocks: For You, Best sellers, Goes with & Frequently bought together Most stores need no block — a sorted collection renders itself. Blocks are for placing a feed somewhere Shopify has no collection: the four you can drop into any theme section, what each does when misconfigured, and the per-visitor cache.

Personalization

3 guides

Goes with

3 guides

Upsell

9 guides
Upsell offers — the six touch points Six places on the path a shopper is already walking where QSortby can suggest another product — cart drawer, free-shipping bar, product page, thank-you page, popup and inside checkout — all fed by the same live ranking. Cart upsell Suggest what's selling fastest in the cart drawer and on the cart page, ranked from your real orders and never showing what's already in the basket. Free-shipping progress bar Show how far a cart is from free shipping and suggest a product that actually closes the gap — not a $5 item against $40 missing. Frequently bought together Suggest what shoppers actually buy in the same order as the product they're viewing, with a best-sellers fallback for the weeks before you have enough pair data. Thank-you page upsell Offer products on the order-status page after payment — every plan, every payment method, and no risk to the conversion you just won. Popup upsell An offer that appears at a moment you choose — after an add to cart, on exit intent, once the cart is near your free-shipping threshold, or after a delay or scroll. Display rules Reusable AND/OR conditions that decide when an upsell shows — cart over $50, contains something from a collection, carries a tag, comes from a vendor. In-checkout upsell An offer inside checkout itself, before payment, so an accepted item joins the same order instead of starting a new one. Shopify Plus only. Intent suggest Let the intent read choose between your ranked candidates, so a gift-buyer and a shopper replacing something get different suggestions from the same cart — or the same feed. Rules first; a learned model only where it has proved it picks better.

Results

4 guides

Settings

3 guides

How ranking works

16 guides
How Best-selling ranking works The default signal: a plain sum of units ordered in the window — no rate, no decay. Framing the stats — rolling, period & snapshot windows Most ranking signals are measured over a time window — and the mode you pick changes which orders and events count. How Trending ranking works The one people miss: trending is momentum, not volume — purchases this window minus the previous equal window, so a fast riser can beat a bigger but flat seller. How Highest-CTR ranking works Ranks by click-through rate = clicks ÷ impressions, raw with no statistical smoothing, so an efficient low-traffic product can beat a more-viewed one. How Most-clicked ranking works Ranks by pull — the sum of clicks through to the product page in the window — the first deliberate step a shopper takes past a grid tile. How Most-impressions ranking works Ranks by raw reach — the sum of impressions in the window — so the most-seen products lead, which grows awareness even when they aren’t the best converters. How Selling-fast ranking works Ranks by urgency — inventory divided by sales rate = days of stock left, lowest first. How Most-added-to-cart ranking works Ranks by buying intent — the sum of add-to-cart events in the window — one step closer to checkout than a click. How Best-converting ranking works Ranks by closing power — purchases ÷ impressions — so a niche product that sells to almost everyone who sees it can lead a far more popular one. How Top-grossing ranking works Ranks by money, not units — summed revenue from the daily sales rollup, so a pricier item can out-rank a higher-volume cheaper one. How Most-profitable ranking works Ranks by the profit margin you set per product — a pure catalog attribute, no behaviour and no time window — so your highest-margin items lead. How Longest-dwell ranking works Ranks by attention — average time on the product page = total dwell ÷ the views that actually timed it — surfacing considered items people study before deciding. How Customer-favorites ranking works Ranks by loyalty — the share of buyers who came back and ordered it in a separate order over the last year, so genuine repeat-worthy products lead. How New-arrivals ranking works Ranks by go-live date, newest first — products that went live inside the window lead, and older arrivals are only used to top the collection up. How Personalize (For You) collections work The one collection with no shop-wide order: QSortby pushes it to Shopify empty on purpose, and your theme renders a different order for every visitor. How segment matching picks each shopper's order Step by step: how a personalization rule routes each shopper — checked top to bottom, first matching group wins, and that group's scoring recipe is what they see.

Help

2 guides

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