# Bundles and value adds

**Learn what bundles and value adds are, how they are defined by accommodations, and how they appear in the Demand API. This guide explains the core concepts, typical value add types, and best practices for presenting included benefits to travellers.**

## What is a bundle?

A bundle is a ready-made accommodation offer that combines a room with one or more value-added benefits, such as free parking, high_speed_internet, or better payment terms.

Bundles are:

* Defined by the accommodation.
* Returned automatically by the Demand API in v3.2, and by including `extras.include_bundle_variants` in v3.1 requests.
* Identified by a bundle ID.
* Reflected directly in the product’s price and policies.
* Are associated to one or more value adds.


You do not need to calculate, assemble, or select bundle components yourself.

### Key characteristics

* Bundles are descriptive, not selectable inputs.
* All included benefits are already reflected in:
  * The product price.
  * Cancellation, meal, and payment policies.
* A product can have at most one bundle.
* Many accommodations may return no bundles at all.


### What bundles are not

| Not a bundle | Why |
|  --- | --- |
| A room rate | Bundles do not define pricing. |
| A payment option | Payment timings are defined by policies. |
| A filter | You cannot request "only bundles with breakfast" |
| A required object | Many accommodations return no bundles. |


## How bundles work in practice

In simplified terms:

1. The accommodation defines value adds.
2. Value adds are grouped into a bundle.
3. The bundle is attached to a rate plan.
4. The rate plan price reflects the included benefits.
5. When the rate plan is attached to a room, the bundle ID becomes part of the bookable product.


## Accommodation-defined value adds

Value adds are the individual benefits included in a bundle. They provide additional value beyond the base stay and are defined by the accommodation.

Value adds are:

* Included automatically with the product.
* Reflected in the product price and policies.
* Returned for display and informational purposes only.
* They cannot be selected, removed, or combined separately.


### Typical value add types

Depending on the property, bundles may include one or more of the following value adds:

* Parking.
* Early checkin or late checkout.
* Welcome drinks.
* High-speed internet.
* Airport transfers.
* Pet-friendly stays.
* Welcome amenities (for example, a bottle of wine or champagne)


**Credits and discounts**

Some bundles include credits or discounts that can be used during the stay, such as:

* Food and beverage credit (per day or per stay, per room or per adult).
* Property credit (per day or per stay).
* Food and beverage discounts.
* Property-wide discounts.


**Experiences and services**

In some destinations, bundles may also include experiences or on-property services, such as:

* Spa access or treatments (daily, hourly, or massage)
* Safari experiences (game drives or guided walks)
* Park-sleep-fly packages.


The exact value adds available depend on the accommodation and destination. Not all properties define bundles or value-added benefits.

## How to display value adds

Value adds should be presented as included benefits, not optional extras. Because they are already reflected in the product price, they should be displayed in a clear, non-interactive way.

**Recommended display principles**

When displaying value adds:

* Group them under a clear label such as “Included with this stay” or “What’s included”
* Use short, benefit-focused labels.
* Avoid showing individual prices for value adds.
* Do not present value adds as selectable options or add-ons.
* Value adds should complement, not compete with, core product information such as price, cancellation, and payment terms.


**Example: Search results or availability list**

In search or availability views, highlight only the most relevant value adds to support comparison.

✔ Late check-out.

✔ Parking included.

✔ €50 food & drink credit per stay.

value-add example display
**Example: Product details page**

On the product details page, display the full list of value adds under a dedicated section.

What’s included:

✔ Early check-in (subject to availability)

✔ Late check-out

✔ High-speed internet

✔ Bottle of wine on arrival

value-add in product display
**Example: Credits and discounts**

When displaying credits or discounts:

* Always include the scope (per day / per stay)
* Clarify whether they apply per room or per adult.
* Do not convert credits into implied cash value outside the stay.


> *€20 property credit per day (per room)*


**Example: Experiences and services**

Experiential value adds should be displayed as included experiences, not upsell activities.

Recommended:

✔ Daily spa access.

✔ Safari game drive included.

**Accessibility and localisation considerations**

Use icons only as visual support; always include text labels.
Localise value add descriptions using the translated strings returned by the API.
Preserve units, currency, and frequency exactly as returned.

Best practice
If space is limited, prioritise value adds that materially influence booking decisions, such as credits, parking, late check-out, or included experiences.

## Next steps

Curious to know more?
Looking to implement bundles in your integration? See [Retrieve and display bundles and value adds guide](/demand/docs/accommodations/bundles/bundles-quick-guide).