Skip to main content
Product Groups

​
Introduction

Product Groups are the theme’s solution for linking separate products so they behave like variants of one another. This allows each product to have its own description, variants, and images, while still being presented as part of a unified group.

​
Setup

Product Groups Metaobject To create and display product groups, follow these steps:
1

Create product groups metaobject definition

You need to create a metaobject definition for product groups.

  1. In the Shopify admin, go to Content → Metaobjects → Add definition.
  2. Create a Product Groups metaobject definition:
    • Name: Product Groups
    • Handle: product_groups
  3. Add following fields to the definition:
    Field NameType
    NameOne : Single line text
    GroupList : Product
    Group by optionOne : Choice list (Single line text)
    (ex. Color, Size, Capacity, etc.)
    Type on cardOne : Choice list (Single line text)
    Swatch, Image, Text, Product
    Type on pageOne : Choice list (Single line text)
    Swatch, Image, Text, Product
    Custom label on pageOne : True or false
  4. Save the definition.

Important Note: Keys are important, please use exactly as shown above.
2

Link the created metaobjects in theme settings

Finally, you need to link the created metaobjects in the theme settings.

  1. Go to Online Store → Themes → Customize → Theme settings → Products.
  2. In the Product Groups section, select the created Product Groups and Product Options Type Values metaobject definitions.
  3. Save your changes.

​
Creating a Product Group

To create a product group, follow these steps:
  1. In the Shopify admin, go to Content → Metaobjects → Product Groups → Add entry.
  2. Fill in the fields:
    • Name: Enter a name for the product group.
    • Group: Select the products you want to include in the group.
    • Group by option: Enter the name of the variant option that differentiates the products (e.g., Color, Size).
    • Type on card: Choose how the variant options will be displayed on product cards (Swatch, Image, Text, Product).
    • Type on page: Choose how the variant options will be displayed on product pages (Swatch, Image, Text, Product).
    • Custom label on page: Enable this option if you want to use custom labels for the variant options on product pages.
  3. Save the product group.

​
Setting custom values for options

If you want to use custom image or text values for product group options, you need to create entries in the Product Options Type Values metaobject. To create a product options type value, follow these steps:
  1. In the Shopify admin, go to Content → Metaobjects → Add definition.
  2. Create a Product Options Type Values metaobject definition:
    • Name: Product Options Type Values
    • Handle: product_options_type_values
  3. Add following fields to the definition:
    Field NameType
    NameOne : Single line text
    ImageOne : Image (File)
    TextOne: Single line text
  4. Save the definition.
  5. Create entries for each custom option value you want to use.
Important Note: Keys are important, please use field names exactly as shown above.

​
Important Notes

  • The theme will use Shopify’s native swatch metaobject (shopify—color-pattern) for Swatch type variant options by default.
  • If you use Product type for variant options on product cards or pages, the theme will display the product images.