Product page

The product page — image, price, variant picker, and add to cart.

What it’s for. Selling a single card or sealed product. For singles it shows condition swatches (NM/LP/MP/HP/DMG) and finish swatches (Foil/Non-Foil), live stock per condition, a quantity stepper, and a one-tap playset button sized to the game. Sealed and non-card products just get the normal price and add to cart.

When to use it. It’s the product template — nearly every store keeps it. It controls how variants are shown, which detail tabs appear, the buylist button, related products, and recently viewed.

TCG features

  • Condition swatches — NM/LP/MP/HP/DMG. Built from the variant option named “Condition” (or, if it’s unnamed, from values like “Near Mint”). Sold-out conditions are struck through; conditions with 1-10 left show the count.
  • Finish swatches — Foil / Non-Foil, from the “Finish” option (or values containing foil/holo/etched). Foil is listed first, and the page defaults to the cheapest in-stock foil.
  • Playset quick-add — adds a full set in one tap: 4 cards, or 3 for Yu-Gi-Oh and Flesh and Blood. Only appears on products typed as “Singles” with enough stock.
  • Detail tabs — Description, Set Details, and Shipping & Returns, driven by product metafields (see docs/metafields.md).
  • Buy Now — Shop Pay / Apple Pay / Google Pay dynamic checkout.

Ways to use it

  • Singles — condition + finish swatches, stock counts, playset button. The default.
  • Table mode — every condition/finish listed at once with its own qty and Add button. Good for high-variant cards.
  • Sealed / accessories — no swatches, no playset; plain price and add to cart.

Tips

  • Swatches and playset depend on the Sideboard sync’s option names, values, and product type (<Game> Singles). If they don’t appear, check that the product has a real Condition/Finish option and a “Singles” type.
  • Set Details and Shipping & Returns tabs only show when the matching metafields are filled — sideboard.* card data or custom.set_details, and custom.shipping_returns (falls back to the section’s default text). See docs/metafields.md.
  • Playset sizes are fixed by game in the theme; the only control is the on/off switch.
  • Per-order purchase limits come from custom.max_per_order or the section’s limit setting.
  • The image area flips to a card back when the product has a second image — set image 2 to the back.

Settings

SettingTypeWhat it does
Show vendorOn / offDefault: false

Product image

SettingTypeWhat it does
Maximum image widthSliderCaps the product image size. On desktop the details column moves in next to the image.

Product Description

SettingTypeWhat it does
Description displayDropdownChoose how to display product description and details (Plain text, Tabbed sections)
Description placementDropdownFull width gives the description and tabs room under the card image. In-column keeps it beside the image but can squeeze the tabs. (Full width below columns, Inside the info column)
Default shipping & returnsRich textGlobal default shown in the Shipping tab. Override per product with the ‘custom.shipping_returns’ metafield (rich text).
Show ‘Set Details’ tabOn / offDefault: true
Show ‘Shipping & Returns’ tabOn / offDefault: true

Buylist / Sell CTA

SettingTypeWhat it does
Show “Sell Us This Card” buttonOn / offSends shoppers to your Sideboard buylist, pre-searched for this card. The store handle and the card’s game are resolved by Sideboard automatically — no setup needed. The button only appears on card products.
Button labelTextDefault: Sell Us This Card
Open buylist in a new tabOn / offDefault: false

Purchase limit

SettingTypeWhat it does
Default max quantity per orderNumberAnti-scalper cap applied to every card. Leave 0 for no limit. A product’s custom.max_per_order metafield overrides this per-card.
Variant display modeDropdownSwatches let customers switch between variants. Table shows all variants at once with individual add-to-cart buttons. (Swatches (switch between variants), Table (show all variants))
Show condition swatchesOn / offDisplay NM/LP/MP/HP/DMG condition swatches (swatch mode only)
Show finish swatchesOn / offDisplay Foil/Non-Foil finish swatches (swatch mode only)
Show playset buttonOn / offQuick-add a full playset (4 for MTG/Pokemon, 3 for Yu-Gi-Oh/FAB)
Quantity, Add to cart & playset on one rowOn / offPlaces the quantity stepper, Add to cart button and playset button side by side on one line (desktop). Falls back to stacked on mobile. Best with short button text.
Show dynamic checkout buttonOn / offBuy-it-now / wallet button (Shop Pay, Apple Pay, Google Pay). Which wallets appear is controlled in Admin → Settings → Payments.
Hide “More payment options” linkOn / offThe Shopify-generated link under the dynamic checkout button. It simply continues to standard checkout.
SettingTypeWhat it does
Show related productsOn / offDefault: true
Number of related productsSliderDefault: 4
ColumnsDropdown2, 3, 4, 6, 8
Swipe carousel on mobileOn / offDefault: true
Mobile columnsDropdown1, 2, 3

Recently Viewed

SettingTypeWhat it does
Show recently viewed productsOn / offDefault: true
Number of recently viewed productsSliderDefault: 4
ColumnsDropdown2, 3, 4, 6, 8
Swipe carousel on mobileOn / offDefault: true
Mobile columnsDropdown1, 2, 3

Was this page helpful?

Spotted something wrong, or want to suggest an improvement? Email support → — your message goes straight to engineering.