# Bundles

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

{% hint style="info" icon="lightbulb" %}
A bundle groups multiple SKUs into a collection with a special price, activated within a market. Only a manual SKU list can be linked to a bundle, and it cannot be modified once associated.
{% endhint %}

## What is a bundle?

A [bundle](/core-api-reference/bundles.md) is a collection of SKUs sold together at a special price. The SKUs are associated with the bundle via SKU list items belonging to a manual SKU list — only manual SKU lists can be linked to a bundle.

Bundles can be activated within a specific market. Once a price is assigned, the currency is inherited from the market relationship. If no market is specified, a currency must be assigned directly to the bundle. You can set both a price amount and a compared price amount, which is often used to display a percentage discount. The compared price can also be calculated automatically as the sum of all individual SKU prices in the bundle.

A maximum of ten SKU list items is allowed for the SKU list assigned to a bundle. Once a SKU list is associated with a bundle, it cannot be modified — new items cannot be added, deleted, or updated unless the linked bundle is first deleted.

## Creating a bundle

Creating a bundle for a market requires three steps:

1. Create some SKUs.
2. Create a manual SKU list and assign SKUs to it via SKU list items.
3. Create a bundle with an associated SKU list, special price, and market.

Once set up, you can use the bundle in a sales channel as needed.

## Use cases

Bundles are a good fit for:

* Selling **special kits** that include multiple items.
* Selling **gift sets** that include items with multiple variants.
* Selling **gift boxes** that include multiple items.
* Selling products that are only available as part of a bundle and cannot be purchased individually.


---

# 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://docs.commercelayer.io/data-model/products/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.