# Variant Bundles

It is possible to combine multiple variants into a single order product and have each of the variants fulfilled. This is advantageous to allow consumers to choose variants sold as a bundle.

For example, a package of 5 t-shirts is sold for $29.99. The consumer can choose color, size, and quantity of each shirt. This pricing does not lend itself to a traditional product & variant. Instead designate the product as a bundle AND submit the order with a separate product & variant combination for each variant. The variants will be combined into a single product (5-pack) on the order but each chosen shirt will be fulfilled.

First, enable this functionality on the product. The checkbox is available only after variants are created on the product.

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

Second, pass regular product and variant parameters passed into the order/import or upsale/import API. Here is an example for a bundle of 3 variants:

**product1\_id = {campaign product Id}**\
**variant1\_id= {variant detail Id for first variant}**\
**product1\_qty = {quantity of first variant}**\
**product2\_id = {campaign product Id}**\
**variant2\_id= {variant detail Id for second variant}**\
**product2\_qty = {quantity of second variant}**\
**product3\_id = {campaign product Id}**\
**variant3\_id= {variant detail Id for third variant}**\
**product3\_qty = {quantity of third variant}**

Full API documentation is [here](https://apidocs.checkoutchamp.com/?version=latest#intro).

The variants will be automatically combined into a single order line item for the product.

**Notes:**

1. Additional products are allowed on the order. Only the products with the Bundle Variants checkbox will be combined.
2. The product may be recurring. The variants will be fulfilled on each subsequent billing. Variants may be edited manually on the Purchase Details page.
3. The bundled variants must all be of the same base product.
4. The combined order product will have a quantity of 1. You must control the quantity of each variant. For example, if the product is a 5-pack of t-shirts, it is the responsibility of the page to validate that variant quantities add up to 5. The order/import and upsale/import API do no quantity validation.
5. This is available with a direct API integration only. It does not work with Konnektive form code or in manual order entry.
6. Variant IDs are available in the campaign/query API response. Details [here](https://apidocs.checkoutchamp.com/?version=latest#0c72ff61-4615-4f18-80d1-f411a3a90cee).


---

# 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://help.checkoutchamp.com/crm/crm-setup/product-setup/product-variations/variant-bundles.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.
