Bulk Card Search
A paste box that turns a decklist into a cart.
What it’s for. Someone pastes a list — one card per line, like 4 Lightning Bolt or 1 Sol Ring — and you resolve every line against your live stock at once. Each line comes back sorted into Found, No stock, or Not found, with the requested quantity already filled from what’s on the shelf. They review, tweak, and add the whole list to cart in one click.
When to use it. On a dedicated page built from the page.bulk-search.json template (it ships with one). It needs the Sideboard app connected — matching runs through the Sideboard resolver, and live price/stock come from your Shopify products. With nothing connected it falls back to a rough Shopify name search (top product per line), which is much weaker. Turn on the demo fixture only while you’re still wiring the backend up.
Ways to use it
- Commander deck dump — a 99-card list resolves in one request; short-filled lines flag with a warning so the buyer sees you’re three short on Sol Ring.
- Buylist-to-cart for a regular — they keep a wants list, paste it weekly, add what’s in stock.
- Set codes and finish — lines like
4 Mox Opal (SOM) *F*are parsed for set and foil, not just name.
Tips
- Stock is read live from your Shopify products at resolve time, not cached. A card only lands in Found if a variant has stock; if you carry it but it’s at zero, it goes to No stock, and unrecognized lines land in Not found with the pasted text echoed back — nothing is silently dropped.
- Each Found card auto-fills the cheapest in-stock variant first by default, cascading into the next printing or condition when one runs short. Flip the auto-fill setting if you’d rather lead with the priciest. Either way the buyer can open any card and mix printings and conditions by hand.
- Conditions and finish come from your product options (option 1 = condition, option 2 = finish). If those aren’t set up consistently, the condition labels (NM/LP/MP/…) won’t read right.
- Add all available adds everything selected in one go. If a variant sold out between resolve and checkout, that one row gets marked sold out and the rest still add — the batch never fails as a whole.
- Buyers can hit Ctrl/Cmd+Enter in the box to resolve without reaching for the button.
Settings
| Setting | Type | What it does |
|---|---|---|
| Heading | Text | Default: Bulk Card Search |
Auto-fill
| Setting | Type | What it does |
|---|---|---|
| Default variant when auto-filling a list | Dropdown | When a pasted card is in stock in multiple conditions/printings, the requested quantity is auto-filled starting from this end of the price range and cascades into the next variant when stock runs short. Buyers can still adjust every line. (Lowest price first, Most expensive first) |
Demo / development
| Setting | Type | What it does |
|---|---|---|
| Use demo fixture data | On / off | When enabled (or ?bulk_fixture=1 in the URL), results are served from a static fixture matching the §3 contract so the page works before the backend endpoint is live. |
Spacing
| Setting | Type | What it does |
|---|---|---|
| Padding top | Slider | Default: 40 |
| Padding bottom | Slider | Default: 40 |
Was this page helpful?
Spotted something wrong, or want to suggest an improvement? Email support → — your message goes straight to engineering.