How to Configure Product Groups for a Collection

What This Task Does

This task defines the option structure shoppers will use to switch between related products inside a collection.

Use it when you already have the collection and want to turn related products into a grouped selection experience.

Before You Start

Make sure:

• the collection already exists
• the relevant products are already in that collection
• the products share the right brand and product type context
• the attributes you want to use as options already exist

Steps

1. Open Settings > Collections.
2. Open the target collection.
3. In the Product Groups section, create a new group or edit an existing one.
4. Choose the product type the group should apply to.
5. Add the attributes that should become shopper-facing options.
6. Choose the display type for each attribute.
7. Save the group.
8. Build or rebuild the group.
9. Review duplicate combinations or missing requirement warnings if they appear.
10. Activate the group when the results are correct.

What Happens Next

After the group is configured and active:

• matching products can appear as grouped options on the product page
• shoppers can switch between related products through the configured option controls
• future attribute or product changes can require another rebuild

Common Mistakes

• Choosing attributes before the underlying product data is clean.
• Forgetting to rebuild after changing the group definition.
• Expecting product-group behavior from the storefront when the group is still inactive.
• Using a collection that does not actually contain the matching products.

Related Guides

• Catalog & Merchandising
• Product Groups
• Collections
• How to create a collection and add product groups

Sources

• packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/Block.php
• packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/Form/BaseDialog.php
• packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/Form/CreateDialog.php
• packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/Form/EditDialog.php
• packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/ViewProductCombinationsDialog.php
• packages/storefront/src/Livewire/Storefront/Product/ProductGroupBlock.php