Listing Templates & Marketplace Templates

The vault has two templating systems that work together. They're separate on purpose — one controls how the listing reads, the other controls how the marketplace treats it.

Listing Templates (the words)

A Listing Template is your reusable title and description with ~40 placeholders. Manage them at /settings/templates.

Example title template:

{year} {set} {player} {variant} #{number} {grade}

When applied to a card, the placeholders resolve from the card row:

2023 Crown Zenith Charizard VMAX Alt Art #20/20 PSA 10

Description templates are full HTML with the same placeholder set, plus a few computed values (e.g. {pricecharting_url}, {recent_sold_count}). Every dealer ends up with a few of these — a graded-card template, a raw-singles template, a sealed-box template.

You can mark one as the default. Listings inherit the default unless you override it on the card or the Marketplace Template.

Marketplace Templates (the wrapper)

A Marketplace Template bundles eBay-side defaults so you don't pick them on every listing. Manage them at /connections/ebay/marketplace-templates.

A template captures:

• Payment policy (from your synced Business Policies)
• Fulfillment policy
• Return policy
• Default category (Pokemon Singles, Sports Cards: Singles, Sealed Boxes, etc.)
• Default location (city, postal code — eBay needs this on every offer)
• Default condition (Used / New / Graded)
• Default listing format (FixedPriceItem, Auction)
• A linked Listing Template for title/description

Most dealers run two or three Marketplace Templates — one for graded, one for raw singles, maybe one for sealed.

How they combine at publish time

When you click List on eBay on a card:

1. The vault picks the active Marketplace Template (per-card override, batch default, or your account default).
2. The Marketplace Template tells the vault which Listing Template to use for title + description.
3. Placeholders resolve from the card data.
4. Business Policies, category, location, and condition come from the Marketplace Template.
5. The offer is validated and submitted.

Once Wave 2 automation rule engines ship, those rules will be able to override the Marketplace Template based on conditions (e.g. "raw cards under $5 use the cheap shipping policy").