Variants & swatches

How Matat turns a set of individual ERP items into a single Shopify product with selectable options — and makes color and size display correctly on your storefront.

From ERP items to one product

Many ERPs store every size/color combination as its own line. Shoppers, though, expect one product page with a size and color picker. Matat bridges this:

 ERP items                         Shopify product
 ─────────                         ───────────────
 SHIRT-RED-S  ($20, 5 in stock)    "Shirt"
 SHIRT-RED-M  ($20, 2 in stock)      Option: Color = Red, Blue
 SHIRT-BLU-S  ($20, 0 in stock)  →   Option: Size  = S, M
 SHIRT-BLU-M  ($20, 7 in stock)      → 4 variants, each with its
                                        own price & stock

Options & variants

Each variant keeps its own SKU, price, and stock, synced from the matching ERP item. The product (the parent) carries the title, description and images. Shopify allows up to three option dimensions per product (for example Size + Color + Material); if your ERP distinguishes more, only the most meaningful are used as options.

How variants are matched on re-sync

On every sync, Matat finds the existing product in your store and compares variants by SKU:

⚠️ SKUs must line up

Matching is exact. If the same variant has a different SKU in your store than in your ERP, Matat can't tell they're the same and may add a duplicate. Keeping SKUs identical on both sides is the single most important thing for clean variants. See Things to know.

Color & size swatches

Shopify can show a little color chip (a swatch) next to each color option on your storefront. Matat links your color and size values to Shopify's built-in swatch library automatically during sync, so "Red" shows a red chip rather than plain text.

The Variant attributes screen

This screen gives you precise control over how option values appear. It:

  1. Discovers every color and size value used across your catalog.
  2. Shows how each one currently appears on your storefront (its swatch, if any).
  3. Lets you adjust the mapping — for example set the base color for a custom shade, or how a value should be rendered.

Save stores your changes in Matat (your storefront is untouched at this point). Applying them to the store updates the swatches on your next sync or via the apply action. Most stores never need this screen — the automatic matching handles the common cases — but it's there when a shade needs a nudge.

ℹ️ "Plain option value"

If you see a note that a value is a "plain option value" with "no swatch metaobject", it simply means that value isn't a recognized color/size yet — it still works as a text option; it just won't show a swatch until it's mapped.

Keeping variants healthy