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.
• Identified by a bundle ID.
• Reflected directly in the product’s price and policies.
• Are associated to one or more value adds.

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

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.

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

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

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.

Next steps