Skip to content
Back to articles

June 18, 2026 · "4 min read"

"Understanding Label One's Color Variant System"

"A deep dive into how the product siblings feature works, from basic setup to advanced metafield configuration."

Label One's color variant system — called Product Siblings — lets you link related products (like the same t-shirt in different colors) and display them as interactive swatches on collection pages and product pages.

How it works

Each product in a sibling group shares a common identifier. When a customer views a collection page, Label One looks up all products with the same identifier and renders their swatches below the main product image.

Setup methods

There are three ways to group products:

By product type

The simplest approach. Give all color variants the same product type (e.g., "Cotton T-Shirt") and enable matching by type in Theme Settings → Product Cards.

By tag

Add a shared tag like color-group-basic-tee to each variant product. This gives you more control over which products appear together.

By vendor

Group all products from the same vendor. Useful for branded collections where each vendor represents a distinct product line.

Advanced: metafield setup

For precise control, use metafields:

  1. Create a metafield definition with namespace swatch and key product_identifier
  2. Set the same identifier value on all related products
  3. Add product.swatch_color for the color name
  4. Optionally add product.swatch_image for custom swatch images

This approach is recommended for stores with complex product relationships.