# 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="https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/84tv2DnzfmTFGW7MhBcG/21018443157010" 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 %}
