User Guide

Search limit to:






Product siblings

by Admin on Jul 21, 2024

1. What are product siblings?

Product siblings refer to the ability to link directly to other products as product swatches on a product detail page. This feature allows you to display swatches with images and information representing each variant option of a product. The result is a richer and more informative product detail page, enhancing the shopping experience by visually displaying related product variants.

When viewing a sibling product, only the images, product details, and prices specific to that variant option are displayed.


2. How to set up product siblings?

To set up product siblings, follow these steps:

Step 1: Create individual products

  • Create individual products, each with variants like sizes, materials, etc.
  • These products will belong to the same sibling group.

Step 2: Group Sibling Products into a Collection

  • Organize the sibling products into a single collection.
  • For multiple sibling groups, create multiple collections.

Step 3: Create and define custom Metafields to link products

  • Sibling Collection Handle metafield: Enter the handle of the collection containing the sibling products. 
  • Sibling Option metafield: Enter the name of the sibling option that will link the individual products (e.g., Color).

Step 4: Update Metafield information for each product

  • Update the metafield information for each product to ensure they are properly linked.
  • For collection handle metafield: fill in the handle of the collection containing all the siblings. Collection handle is the final part of the collection URL and can be found in the 'Search engine listing' section in admin collection detail page
  • For Sibling Option metafield: fill in the value of the option which links all sibling products of the abovementioned collection. You can use bulk update to fasten the process.

Step 5: Add the Siblings block to the Product template

  • Go to the Theme Editor and add the Siblings block to the product template.
  • Enter the name of option sibling (e.g: Color,..)
  • Enter the keys for the two metafields created in Step 3 into the block.

By following these steps, you can set up product siblings to display linked product swatches with relevant images, details, and prices for each variant option.

3. How to show color swatches for siblings options?

This setup is similar to the current logic used for color swatches in the theme. Refer to the Eurus theme's product swatches documentation for detailed guidance.

Example:

4. How to show sibling options in cart, checkout and order detail page?

The Eurus theme automatically supports the display of sibling options in the cart, checkout, and order detail pages. This ensures consistent product information across all stages of the shopping process.

Example for the product “Long Lasting Cream Eyeshadow Stick” which has 3 variants: Orange/Pink/Red

In cart page:

In check out page:

In other details page:

Note

  • The Eurus theme supports various types of product metafields. 

    Supported option value metafields include:

    • Multi text
    • Single line text
    • Ratings (one value evidence)
    • URL (evidence)
    • True/false (evidence)
    • Color
    Partially supported Metafields  (displayed as code/variables - to be updated in next updates):
    • Rich text
    • Metaobject product list
    • Dimension (list value)
    • Dimension (one value)
    • Volume
    • Weight (evidence)
    • All list types (such as collection list, URL list, ratings list)
    Unsupported option value metafields include:
    • Product/Product list
    • Date/time
    • Page/Page list
    • Metaobject
    • If a product belongs to a sibling collection but does not have a value in the sibling option metafield, it will not be displayed on the front end .
    • Priority of option values: If there are duplicate names between sibling options and customizable options, only the last option (from top to bottom) will be shown in cart, checkout and order detail page.