Pyle

Product Groups ​

What This Is ​

Product Groups define how related products inside a collection are presented as selectable options to shoppers.

They are an advanced merchandising feature. Instead of treating every related product as a disconnected item, Product Groups let you present related products through option selectors such as color, value, or card-style choices.

When You Would Use It ​

Use Product Groups when you need to:

  • let shoppers switch between related products on the product page
  • define which attributes should act as the selectable options
  • keep a collection of related products organized by product type and option values

Do not use Product Groups when you only want a collection record. Product Groups are about shopper-facing option behavior, not only grouping records in admin.

Before You Start ​

Before you create or edit a Product Group, make sure:

  • the collection already exists
  • the collection already contains the related products you care about
  • the products share the right product type and brand context
  • the attributes you want to use already exist

How To Use It In The Admin ​

  1. Open Settings > Collections.
  2. Open the collection you want to work in.
  3. Go to the Product Groups section on the collection page.
  4. Create a new Product Group.
  5. Choose the product type the group should apply to.
  6. Add the attributes that should become shopper-facing options.
  7. Choose the display style for each attribute.
  8. Save the group and build it.
  9. Review the group again if you need to activate it, rebuild it, or inspect duplicate combinations.

Important note:

Product Groups are not managed from a separate top-level menu in the packaged product. They live inside a collection.

What It Changes In The Storefront ​

Product Groups can directly change the product detail page by:

  • showing option selectors for related products
  • letting shoppers switch to matching products
  • controlling which product combinations appear available

If the group is inactive or incomplete, shoppers may not see the grouped option behavior you expect.

Common Tasks ​

Create a new Product Group ​

Create it from the collection page, choose the product type, add the attributes, and build the group.

Rebuild a Product Group ​

Use this when products, attributes, or combinations have changed and the group needs to be recalculated.

Activate or deactivate a Product Group ​

Use the edit flow to control whether the group should affect the shopper-facing experience.

Review duplicate combinations ​

Use the product-group review tools when more than one product is ending up with the same option combination.

Import Product Groups in bulk ​

Use the dedicated Excel import when you need to update many groups at once.

Rules, Limits, And Things To Watch ​

  • Product Groups are tied to a collection, a product type, and a brand context.
  • If the related products do not line up correctly, the group can build incomplete or confusing combinations.
  • Changing attributes can require a rebuild.
  • Very large groups may be processed differently from small ones.

Troubleshooting ​

I do not see Product Groups as a top-level menu ​

That is expected. Manage them from inside a collection page.

I built the group, but shoppers still do not see the options I expected ​

Check whether the group is active, whether the products are in the right collection, and whether the right attributes were selected.

I see duplicate or broken combinations ​

Use the group review and combination tools, then adjust the attributes or product data and rebuild the group.

Sources ​

  • packages/admin/src/Livewire/Admin/Settings/Collection/ProductGroups/Block.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/framework/src/Services/ProductGroup/ProductGroupService.php
  • packages/framework/src/Imports/ProductGroup/ProductGroupImport.php
  • packages/storefront/src/Livewire/Storefront/Product/ProductGroupBlock.php