# Setting up product-listing variant families for bol

Bol allows you to group your variants into families. Bol has [some prerequisites](https://developers.bol.com/deliver-product-variants-families-in-bulk/) for creating families. In order to configure your bol API in Channable so that your variants will be grouped into families on Bol.com, follow the steps below.

{% stepper %}
{% step %}

### Check your general API setup

For the products that you want to group, check the following things in your Bol.com API in Channable:

* The products should have the same **category** in the *Categories* step of your Bol.com API.
* The products should have the **same value** for the 'Brand', 'Author' or 'Artist' attribute in the *Attributes* step.
* The products should have **different values** for their distinctive feature attributes (for example 'Size', 'Color' or 'Shoe Size') in the *Attributes* step.
* You have a maximum of 70 variant products per family group.

{% hint style="warning" %}
Important: You have a maximum of 70 variant products per family group. When you send more than 70 products this will not return an error but Bol.com will not publish all products.
{% endhint %}
{% endstep %}

{% step %}

### Configure the 'Productvariant ID'

In order for Bol.com to group your variants, they need a 'Family Key'. This family key can be set up in Channable in the **Build** step in the attribute **'Productvariant ID'**:

<figure><img src="/files/b0e034b18fc588e41b33bc8f4b1b9f5f74e86bbb" alt=""><figcaption></figcaption></figure>

Here you need to select an identifier that is the same for all variants within a family. This is often a field called `item_group_id` or `parent_id`.
{% endstep %}

{% step %}

### Send your product families to Bol.com

After configuring the above, run the Bol.com API and check if the families are configured correctly in your Bol.com seller account.

For more information on how adding families to Bol.com works on bol's side, read [their article](https://developers.bol.com/deliver-product-variants-families-in-bulk/). It also contains an example table and a Q\&A.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.channable.com/list-advertise/bol/list-items-on-bol/setting-up-product-listing-variant-families-for-bol.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.