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:
- It identifies the shared model behind a set of items (from a model field or derived from the SKU, depending on your grouping setting).
- All items sharing that model become one product.
- The ways they differ become options (Size, Color, …) with one variant per combination.
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:
- A variant whose SKU already exists is updated in place (price, stock).
- A new SKU is added as a new variant.
- Variants in your store that your ERP no longer lists are left alone — Matat never deletes variants automatically.
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.
- This happens as a separate step after the product is created or updated, so adding a new color never disrupts the existing product.
- Swatch linking requires the product to have a category — set the Default product category in Settings so this works.
- When Matat creates a new color swatch, Shopify requires a base color (so a shade like "Sand" is grouped under, say, Beige). Matat supplies a sensible base automatically, and you can override it on the Variant attributes screen.
The Variant attributes screen
This screen gives you precise control over how option values appear. It:
- Discovers every color and size value used across your catalog.
- Shows how each one currently appears on your storefront (its swatch, if any).
- 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.
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
- Use the same SKUs in your ERP and your store.
- Keep the same option structure on both sides (don't collapse color in the store if your ERP splits by color).
- Set a default category so swatches can link.
- Pick your grouping strategy carefully at setup — it can't be changed later.