Card VaultAI← Home

SKU customization

Configure the SKU format the vault generates so it matches your existing scheme.

Last updated May 11, 2026

Every card needs a SKU. The vault generates one automatically the moment a card moves to priced, using a format you control. Configure it once at /settings/inventory and every card from that point forward picks up your format.

Why customize

Lots of dealers already have a SKU scheme that's wired into other systems — a label printer, a Google Sheet, an accounting export. Forcing you to adopt a new scheme to use the vault is a non-starter. The customization lets us match your existing format on day one.

Placeholders

The format string supports the following placeholders, resolved per card:

PlaceholderResolves toExample
{batch}The batch's short codeB47
{seq}Sequential number within the batch, zero-padded0023
{sport}Sport / category codePOK
{set}Set codeCRZ
{year}Card year (two or four digit)23 / 2023
{grade}Grade if graded, blank otherwisePSA10
{location.dim1}First storage dimension (Container)A
{location.dim2}Second storage dimension (Row)3
{uuid}A short 8-char hash of the card IDf3a91c40

You can mix freely. Common formats we see:

  • {batch}-{seq}B47-0023 (simplest — Numeric within batch)
  • {set}-{year}-{seq}CRZ-23-0023 (set-first, useful for sorted storage)
  • POK-{set}-{seq}-{grade}POK-CRZ-0023-PSA10 (sport-prefixed for multi-sport dealers)
  • {location.dim1}{location.dim2}-{seq}A3-0023 (location-first for binder dealers)

Static text

Anything outside the curly braces is treated as literal. So VAULT-{batch}-{seq} produces VAULT-B47-0023.

Uniqueness

The vault enforces that no two cards in your account have the same SKU. If your format isn't unique (e.g. {set} alone would collide on every card in the same set), the importer surfaces a warning and refuses to commit until you fix the format.

Manual override

You can always override a SKU on the individual card. Useful for one-off cards from special sources where you've already labeled the physical card with a different code. Manual SKUs aren't regenerated when the format changes.

When the format changes

If you change the format at /settings/inventory, only new cards (those without a SKU yet) pick up the new format. Existing SKUs are left alone — silently rewriting historical SKUs would break every label and external reference. There's a separate "Re-generate SKUs for batch" tool if you want to apply the new format retroactively to a specific batch.

Where the SKU shows up

  • On the card detail page in the header (large, monospaced — easy to read off a label).
  • On printed labels (the SKU is the barcode value by default).
  • In CSV exports as the sku column.
  • On eBay listings as the eBay-side SKU (the listing's seller_sku).