> For the complete documentation index, see [llms.txt](https://usermanual.ergonode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usermanual.ergonode.com/products/catalog/creating-new-product/grouping-product.md).

# Grouping product

Create a grouping product that gathers simple products or products with variants into one set, and add its children.

## Introduction

A grouping product gathers simple products or products with variants into a set with one or more common features. For example, if you run a store with leather accessories, you may want to create a set of products such as a wallet, suitcase, and belt, making it visible under one listing in your store search and managing it with a specific set of attributes and categories.

To create a grouping product, follow the same steps as for a [simple product](https://usermanual.ergonode.com/products/catalog/creating-new-product/simple-products), but choose ***Grouping product*** from the ***Product type*** drop-down of the ***Create product*** window.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FnJa0o5yWkdeWqOR4qew8%2Fimage.png?alt=media&#x26;token=ed6a000b-5bae-4443-ab0d-ad8f99a3d6bf" alt="" width="563"><figcaption></figcaption></figure>

Fill in the other fields the same way; choosing categories is optional, and the ***Category*** list works like the ***Category*** quick filter, described in [Quick filters](https://usermanual.ergonode.com/products/catalog/quick-filters). The differences will appear after you have created the product and moved to edit it.

A ***Children*** tab will become available, where you can select simple products or products with variants to add to your group. The number next to the tab name shows how many products are in the group.

The tab lists the grouped products with their SKU, template, default label, default image and quantity. It is the same grid as in the catalog: you can search in the filter row below the column titles, sort by a column and move columns by drag-and-drop, as described in [Table view (Grid view)](https://usermanual.ergonode.com/products/catalog/system-views/table-view-grid-view). Use the icons in the upper left corner to switch between table view and tile view ([System views](https://usermanual.ergonode.com/products/catalog/system-views)) or to open [Display settings](https://usermanual.ergonode.com/products/catalog/system-views/display-settings) (***settings (gear)*** icon). In each row, the ***eye*** icon opens the child product and the remove icon detaches it from the group.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FL3WZl7eiSQPIjGC5hzce%2Fimage.png?alt=media&#x26;token=150e70d0-23cb-4414-a36d-62f221e36c5b" alt=""><figcaption></figcaption></figure>

## Add a new Children product

To add products, click ***Add products*** on the right side of the grid bar. Then choose ***Select from list*** or ***Add by SKU***.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F1VhqmaH77SnIu4pteBMB%2Fimage.png?alt=media&#x26;token=0c8a9fc9-2a67-4478-b0b5-7c94322a044b" alt=""><figcaption></figcaption></figure>

### By SKU

Add the SKU of the product or products you wish to add, separating multiple SKUs with a new line or comma. Then click ***Add to product group*** to confirm or ***Cancel*** to close the window.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2F4onGpCNi1UIjfOmgaWd6%2Fimage.png?alt=media&#x26;token=66463ec2-04aa-4004-84f8-cf8ba9ba039e" alt="" width="563"><figcaption></figcaption></figure>

### Select from list

Tick the product you wish to add, then click ***Save changes*** to confirm or close the window to cancel. The number on the button shows how many products you have ticked.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FEjlwB2nd5r9B4gb5T7Ow%2Fimage.png?alt=media&#x26;token=1317b31b-d9a8-4d84-9a89-e600ca052a74" alt=""><figcaption></figcaption></figure>

You can choose between table view and tile view ([System views](https://usermanual.ergonode.com/products/catalog/system-views)), or open [Display settings](https://usermanual.ergonode.com/products/catalog/system-views/display-settings) (***settings (gear)*** icon), with the icons in the upper left corner of the window. The window's grid works like the one in the catalog: search, sorting and moving columns are described in [Table view (Grid view)](https://usermanual.ergonode.com/products/catalog/system-views/table-view-grid-view).

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FzrcHy0ARUgEtlgeoamA9%2Fimage.png?alt=media&#x26;token=a88710a7-bda1-49d2-8d3d-7595e47c1560" alt=""><figcaption></figcaption></figure>

## Detach the product

To detach the child product from the main one, click on the ***remove (circled cross)*** icon in its row and confirm your choice with ***Detach***.

<figure><img src="https://171427267-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM9BbYBbDPiJapb75xJ2k%2Fuploads%2FUmOCvRWnnMMS0ZPQFPrA%2Fimage.png?alt=media&#x26;token=f40ef413-c29d-4ed8-8618-bf38f3814f44" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
Detached products are NOT deleted; they keep their own product type and become standalone products. If you wish to delete it, you must first detach it and then delete it from the [Product Catalog](https://usermanual.ergonode.com/products/catalog) location.
{% endhint %}

{% hint style="info" %}

* The order visible in the system attribute ***Product children*** in the product catalog grid represents the actual order of products grouped under a grouping product.
* The **GraphQL API reflects this same order**.
* The **children grid visible on the grouping product details page does not currently reflect this order**.
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://usermanual.ergonode.com/products/catalog/creating-new-product/grouping-product.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
