Set tracker
Chapter 10 of the Loot user guide.
Collectors buy to finish a set. Loot lets shoppers tick what they already own and see what's missing:
- A "Got it" toggle on product cards (top right of the bubble), on every piece in a Set tracker section, and as "I have this" in the product page's set box.
- The Set tracker section shows every piece of a set as a small blister card, with a progress panel ("7 of 12", one segment per piece with the chase piece in foil, or one bar for sets over 24 pieces, and "58% complete"), All / Missing / Got tabs, and a bar that adds every missing piece to the cart in one go: "Add the 5 missing · $198.00".
- The product page's Set box: "Part of Neon Ronin wave 3 · You have 7 of 12" with a progress ring and a "See what's missing" link.
- The cart nudges: "You're 4 away from Neon Ronin wave 3".
- The header's sets button shows how many sets the shopper is tracking, and links to their My sets page.
- Finishing a set says "Set complete. Nice haul." and throws confetti once (Theme settings › Motion and effects; never with reduced motion).
Where the "owned" list is kept
On the shopper's device only. Ticks are saved in the shopper's own browser (its local storage), not in their customer account, and nothing is sent to you or anyone else. The section says so: "We keep count on this device." That means no sign-in and no app, but also that a shopper's ticks don't follow them to another phone or browser, and clearing the browser's data clears them. If the browser blocks storage, the toggles still work until the page is closed.
Setting it up
- Make a collection for each set (a series, wave, comic run or product line).
- Point products at their set: fill each product's Set metafield (
custom.set_collection, chapter 7) with that collection. Cards then show the "Got it" toggle (with Show "Got it" toggle set to Only for products in a set), and the product page shows the set box. - Add a Set tracker section to your home page or a collection page and choose the set, or rely on the one on the product page, which shows the product's own set.
- Create the My sets page: in admin, Online Store › Pages › Add page, title it "My sets", and choose the theme template page.sets. Then choose that page in Theme settings › Collecting › My sets page. The header's sets button appears once that's set (with Show sets button on in the Header).
Let shoppers track what they own (Theme settings › Collecting, on) is the master switch. Off, every toggle, the progress, the set box's count, the sets button, My sets and the cart nudge go away; the set tracker still lists the pieces with an add-all key.
Set tracker section
| Setting | Default | What it does |
|---|---|---|
| Set | Empty | The collection that holds the set. On product pages, leave it empty to use the product's custom.set_collection. |
| Layout | Panel | Panel: the progress panel beside a six-column grid (for the home page). Strip: a heading row with the add key, then one band of larger cards (for the product page). |
| Background | Page | Page or Alternate band |
| Kicker, Kicker icon, Heading, Text | "Set tracker", Checklist | The heading defaults to the collection's title |
| Show "Add the missing" | On | The add-all bar |
| Add key label | "Add the [count] missing" | [count] becomes the number of missing pieces |
| Show prices | On | Prices on the pieces and the bar's total |
| Most pieces shown | 24 (6 to 50) | Sets larger than 50 show their first 50 |
| Foil for chase pieces | On | Pieces whose custom.rarity is chase get the foil card and the foil progress segment |
The tabs open on Missing once the shopper owns at least one piece, otherwise on All. The add-all key adds only pieces that can be bought and aren't in the cart already, one of each, then opens the cart drawer. If a piece sold out since the page loaded, the rest are still added and a line names the one that wasn't. With no set chosen, the editor shows six sample cards and your storefront shows nothing.
Set box block
On the product page, for products with a Set metafield. Show the "I have this" toggle (on) and Link label ("See what's missing": to the Set tracker section on the same page when there is one, otherwise to the set's collection).
My sets
The My sets section (on the page.sets template) lists every set the shopper has started on this device, with its picture, name, "7 of 12" and a progress bar. Settings: Kicker, Heading ("My sets"), Text, Background, and the empty state's Heading ("No sets yet."), Text, Button label ("Browse the shelves") and Link (defaults to your collections page).
The cart nudge
Show the set nudge in the cart (Theme settings › Collecting, on): under the cart's lines, "You're 4 away from Neon Ronin wave 3", linking to the set, when a product in the cart belongs to a set the shopper tracks and pieces are still missing.