> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Group as Variants

> Attach many products to one parent product as its variants. Turn a flat list of sizes and colors into a single configurable product in one action.

<img className="block dark:hidden" src="https://mintcdn.com/swiftsyncai/JzN4ZaAJl8725TZC/images/marketing-screenshots/products/products-bulk-edit-group-as-variants-light-transparent.webp?fit=max&auto=format&n=JzN4ZaAJl8725TZC&q=85&s=86cbd30aace69a7ea1191a1ba71b9bd2" alt="Bulk editing - Group as Variants across many products at once in WISEPIM" width="2252" height="2004" data-path="images/marketing-screenshots/products/products-bulk-edit-group-as-variants-light-transparent.webp" />

<img className="hidden dark:block" src="https://mintcdn.com/swiftsyncai/JzN4ZaAJl8725TZC/images/marketing-screenshots/products/products-bulk-edit-group-as-variants-dark-transparent.webp?fit=max&auto=format&n=JzN4ZaAJl8725TZC&q=85&s=eb454791adf64ce39f55363062f66249" alt="Bulk editing - Group as Variants across many products at once in WISEPIM" width="2252" height="2004" data-path="images/marketing-screenshots/products/products-bulk-edit-group-as-variants-dark-transparent.webp" />

Imports often arrive flat: every size and every color is its own separate product. **Group as Variants** fixes that. Select the products that belong together, pick the parent they belong to, and WISEPIM attaches them all as variants of that parent.

The result is one configurable product with its variants underneath, instead of twenty look-alike rows. Shoppers get a single product page with a size or color picker, and your channels get a clean, correctly structured listing.

## Group products as variants

<Steps>
  <Step title="Select the products">
    Check the individual products that should become variants. Leave the parent out of the selection - you pick it in the next step, and a selected product can't be its own parent.
  </Step>

  <Step title="Open Bulk Edit and choose Group as Variants">
    Click **Bulk Editing**, then pick the **Group as Variants** card (under Categories & Organization).
  </Step>

  <Step title="Pick the parent product">
    The **Parent product** search shows configurable products by default. Turn on **Show all products, not just configurable ones** to pick a simple product instead - WISEPIM warns you that saving will convert it to a configurable (parent) product.
  </Step>

  <Step title="Apply">
    Click **Apply Changes**. The selected products become variants of the parent, and a toast confirms how many were grouped.
  </Step>
</Steps>

<Warning>
  This action works on a **page selection only** - it is deliberately not available when you select all products across all pages. Grouping every filtered product under one parent is rarely intended, so WISEPIM blocks it rather than letting a stray filter create a 2,000-variant product.
</Warning>

<Info>
  You can attach up to **500 products** in one run. If your selection is larger, split it into batches and run the action more than once.
</Info>

## The parent must be configurable

Only a configurable product can have variants. If the parent you pick is a simple product, WISEPIM converts it to a configurable product as part of the action - the amber warning in the modal tells you before you apply.

Some products can never be a parent, and the action fails with a clear error instead of guessing:

| Rejected as parent                  | Why                                                               |
| ----------------------------------- | ----------------------------------------------------------------- |
| A product that is already a variant | Variants cannot be nested. Pick the top-level parent instead.     |
| A bundle or grouped product         | These group products for sale, which is a different relationship. |
| A virtual product                   | Virtual products do not carry a variant structure.                |

Products **in your selection** are handled more gently: anything that can't become a variant - a configurable product, or a product that already has variants of its own - is silently skipped, and the toast reports how many were skipped. The rest of the selection still goes through.

## When to use it

* **After a flat import.** A supplier file with one row per size becomes one configurable product per style. (The [CSV importer](/en/essentials/importing-products) can also detect and link variants during the import itself.)
* **Cleaning up duplicates.** Products that look like the same item varying by one attribute are usually variants, not separate products.
* **Preparing for a marketplace.** Channels expect variants under a parent. Grouping them first avoids rejected listings.

<Tip>
  Set up a [product family](/en/products/product-families) with a variant axis (size, color) before you group. The family tells WISEPIM which attribute makes each variant different, so the variant picker on your storefront comes out right.
</Tip>

<Note>
  To attach a **single** product, use the **Parent product** field on its Basic Info tab (in the [full editor](/en/products/editing-products) or Quick Edit) - that field appears on simple and virtual products. There is no bulk *un*-group action: detach variants one at a time by clearing that field, or from the parent's Relationships tab.
</Note>

## Related

<CardGroup cols={2}>
  <Card title="Product families" icon="network" href="/en/products/product-families">
    Define the attributes and variant axes that structure your products.
  </Card>

  <Card title="Editing products" icon="square-pen" href="/en/products/editing-products">
    Link variants, bundles, and related products on a single product.
  </Card>

  <Card title="Filtering products" icon="search" href="/en/products/filtering-products">
    Find parents and variants with the Has Variants and Is Variant filters.
  </Card>

  <Card title="All bulk actions" icon="layers" href="/en/essentials/bulk-editing">
    Browse every bulk editing action by category.
  </Card>
</CardGroup>
