Skip to content

Product siblings

SettingTypeDefaultOptions and range
Siblings are separate products shown as one family, such as a coat sold as one product per color. Set up a metaobject for the colors and two product metafield definitions in Custom data, then link each product to its family and its color. How siblings look on product cards is set in Theme settings › Product card.
Show product siblingsCheckboxOn
Data
Sibling list metafield

Namespace and key of a product metafield definition of type “list of products”. List every product in the family, including the product itself.

Shown when Theme settings › Product siblings › Show product siblings is on.

Textcustom.siblings_products
Color metafield

Namespace and key of a product metafield definition of type “metaobject” that points to the product’s color entry. A product without one uses its featured image as the swatch.

Shown when Theme settings › Product siblings › Show product siblings is on.

Textcustom.siblings_color
Metaobject label field key

Shown when Theme settings › Product siblings › Show product siblings is on.

Textlabel
Metaobject color field key

Shown when Theme settings › Product siblings › Show product siblings is on.

Textcolor
Metaobject image field key

Shown when Theme settings › Product siblings › Show product siblings is on.

Textimage
Swatches
Swatch source

Shown when Theme settings › Product siblings › Show product siblings is on.

SelectImage, then color
  • Image, then color
  • Color, then image
  • Color only
  • Image only
Sold-out siblings

Shown when Theme settings › Product siblings › Show product siblings is on.

SelectCross out
  • Cross out
  • Hide
On the product page

“Swap in place” replaces the product without reloading the page and updates its URL. Without JavaScript, swatches are always links.

Shown when Theme settings › Product siblings › Show product siblings is on.

SelectSwap in place
  • Swap in place
  • Go to the sibling’s page