Product groups setup

In this documentation, we'll find the steps for:

1. How to create the Product groups metaobject.
2. How to create the Product options type values metaobject.
3. How to link the metaobjects in the theme's settings.
4. How to test your product groups.

What are "Product groups"?

Product groups is our theme's solution to presenting different products as a variant to one another. This enables you to have different description, variants, images, you can even use entire new templates to link them together.

What are "Product options type values"?

The Product options type values refer to the four settings your products can be displayed in. They are:

1. Image
2. Swatch
3. Text
4. Option

Each of these options can be selected for the "Cards" and "Page". The "Cards" refers to the product cards that can be found on the collection pages or the theme's sections. The "Page" refers to the actual product page.

How to create the product groups metafield:

Step 1:

Access the store's Settings > Custom Data > Add metaobject definition

Step 2:

Name your metaobject as: Product groups

Step 3:

Add a new field and select "Single line text"

1. In the Name filed, type in: Name
2. Check the box for "Use this field as display name"
3. Click on "One value"
4. Check the box for "Use as filter in metaobject index"
5. Check the box for "Required field"
6. Click "Add"

Step 4:

Add a new field and select "Product"

1. In the name field, type in: Group
2. Select "List of values"
3. Check the box for "Use as filter in metaobject index"
4. Check the box for "Required field"
5. Click "Add"

Step 5:

Add a new field and select "Single line text"

1. In the Name filed, type in: Group by option
2. Select "One value"
3. Check the box for "Required field"
4. Check the box for "Limit to preset choices"
5. In the text field below, type in: Color
6. Click on "Add item" to add a new text field
7. In the second field, type in: Size
8. Click "Add"

Step 6:

Add a new field and select "Single line text"

1. In the Name filed, type in: "Type on Card"
2. Select "Single value"
3. Check the box for "Limit to preset choices"
4. In the text field below, type in: Image
5. Click on "Add item" to add a new text field
6. In the second field, type in: Swatch
7. Click on "Add item" to add a new text field
8. In the third field, type in: Text
9. Click on "Add item" to add a new text field
10. In the forth field, type in: Product
11. Click "Add"

Step 7:

Add a new field and select "Single line text"

1. In the Name filed, type in: "Type on Page"
2. Select "Single value"
3. Check the box for "Limit to preset choices"
4. In the text field below, type in: Image
5. Click on "Add item" to add a new text field
6. In the second field, type in: Swatch
7. Click on "Add item" to add a new text field
8. In the third field, type in: Text
9. Click on "Add item" to add a new text field
10. In the forth field, type in: Product
11. Click "Add"

Step 8:

Add a new field and select "True or false"

1. In the Name filed, type in: "Custom Label on Page"
2. Click "Add"

Note: Make sure you have all of the fields above, and then hit "Save", to save your "Product groups" metaobject

How to create "the Product options type values" metaobject:

Step 1:

Access the store's Settings > Custom Data > Add metaobject definition

In the "Name field" type in: "Product options type values"

Step 2:

Add a new field and select "Single line text"

1. In the Name filed, type in: Name
2. Check the box for "Use this field as display name"
3. Click on "One value"
4. Check the box for "Use as filter in metaobject index"
5. Check the box for "Required field"
6. Click "Add"

Step 3:

Add a new field "File"

1. In the name field, type in: Image
2. Select "One file"
3. Check the box for "Accept specific file types"
4. Check the box for "Images"
5. Click "Add"

Step 4:

Add a new field "Color"

1. In the name field, type in: Swatch
2. Select "One value"
3. Click "Add"

Step 5:

Add a new field and select "Single line text"

1. In the Name filed, type in: Name
2. Click "Add"

Note: Make sure you have all of the fields above, and then hit "Save", to save your "Product options type values" metaobject

3. How to link the metaobjects in the theme's settings:

Go to your theme > Theme Settings > Product options

1. In the "Metaobject for product groups" field, type in: product_groups
2. In the "Metaobject for product options type value" field, type in: product_options_type_values

Save the theme changes.

4. How to create a group of products:

Go to your theme's backend > Content > Metaobjects > Product groups > Add entry

1. Name your test entry.
2. Select two or more products that can form a group
3. In "Group by option" select "Color"
4. In "Type on card" select one of the values
5. In "Type on page" select one of the values.
6. Click save

Note: Except for the "Product" value, all of your other values will need to be configured inside the "Product options type values" metaobject.

Contact Us