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.
Getting started
6 guides Start here — what QSortby does QSortby decides what order your products appear in and keeps that order up to date on its own. One paragraph on the idea, then a map of the seven places in the app. Set up QSortby — two steps Setup is two jobs: switch QSortby on in your theme, then auto-sort one collection you already have. It ends when the order on your storefront has actually changed. Home — is QSortby making money? Home answers one question with one number: influenced revenue. Then what is running, what needs attention, and what happened recently. Your first 10 days — the reverse trial Every new install runs on the Growth feature set for 10 days, then settles onto Free. Your first paid plan adds a separate 7-day trial. What that means for what you see, and what changes on day 11. Plan limits — what each tier actually caps The enforced numbers behind the four plans: managed collections, the ranking-window floor, personalization rules, how many of each upsell you can run, and which extras — Goes-with publishing, storefront data, AI connections — each tier carries. Check what the sort actually did Where to look before a new order publishes, how to undo one, which rule was live when, why a product sits where it does, and how to read the revenue figure without over-reading it.
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 Create a personalization rule A rule is groups of shoppers, each with its own order of priorities. Write it, read what it produces with Why this order, then publish — exactly one rule is live at a time, and nothing reaches a shopper until you press Publish. The twelve signals, and what each one needs What every personalization signal measures, which ones work on a first-time visitor, the two context signals that read your orders rather than the shopper, and the ones that quietly do nothing until something else is in place. 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.
Goes with
3 guides Goes with — keep related products next to each other A Goes-with rule keeps related products adjacent after ranking: a candle ranked 2nd and its refill ranked 37th end up side by side, without changing which one ranks first. Written once, used by as many collections as you like. Write a Goes-with rule The rule editor reads as sentences: IF a product matches these conditions, THEN group it by this field. The sections of a rule — which products go together, bring company to a product, never pair these, stop here, out of stock, order within a set — and what each one does. Publish Goes-with sets to a product metafield Write each rule's sets onto your products in Shopify — qsortby.pairwith plus a product list per rule — so your theme can render them in Liquid without calling QSortby. Off until you turn it on; switching it off removes what it wrote.
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 Impact — what the sorting earned Influenced revenue over the range you pick, where it came from, which collections earn their clicks, how the personalized feed did, what moved, and which sort version produced it. One tab, one range, and an honest word for every number. Experiments — prove a sort sells more An experiment splits your visitors between two rankings and measures which one sells more. Three comparison types, a minimum sample that stays on screen, and a verdict that is called directional, never proven. Visitors — behaviour, never identity Every visitor QSortby has served, with what they looked at, what they put in a cart and how they decided — so you can answer “why did this shopper see that order”. It stores behaviour, not identity. Intent — what shoppers came for What shoppers came for in the range you pick — buying a gift, replacing something, close to buying, browsing, treating themselves — how each kind behaves, what is trending with each, when each peaks, and what Intent AI is actually doing for your store.
Settings
3 guides Settings — how the app measures, connects and shares data Six tabs: Tracking, Product data & AI, Integrations, Storefront data, AI connections and Plan. Settings holds measurement and connections, not how your storefront is sorted — sorting lives in Auto-sort, offers in Upsell. Storefront data — related products for your theme Two ways to get each product's related lists into your own theme: a JSON API your theme's JavaScript calls, and metafields written onto every product for Liquid. Bought, added and viewed together, similar, and goes-with. AI connections — Claude and ChatGPT on your QSortby data Connect your own Claude or ChatGPT account to QSortby. The assistant can answer questions about your store's QSortby data — and, where you allow it, set up collections, rules and offers as drafts for you to review. It never sees customer personal data and never changes anything live.
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 Troubleshooting — the four things that go wrong most often Numbers all empty, a surface showing 0 views, an order that looks unchanged, a recipe that does nothing — the four failures support actually receives, what each one means, and the fix. Glossary — every term, in the app's own words Surface, recipe, velocity, trend, slot, audience, Goes with, influenced revenue, padded, snapshot, intent — defined in the same words the interface uses, because a glossary that renames things is worse than none.