# Bundle discount

The **Bundle Discounts** feature allows you to create **custom product bundles** with a fixed price or percentage discount. Unlike standard bundled discounts, this feature operates at the **product level**, giving you more flexibility and control.

It is especially useful for **POS (Point of Sale)** workflows where bundles need to be applied instantly based on scanned items.

{% embed url="<https://dollarlabs.neetorecord.com/watch/2c60345d0b55279149b2>" %}

***

### Key Capabilities

* Create bundles using **specific product combinations**
* Set bundle pricing as:
  * Fixed total price
  * Percentage discount
* Define **shared components** across multiple bundles
* Control **bundle priority** to determine which discount applies first
* Support for **multiple bundle repetitions**
* Optimized for handling **large and complex bundle configurations**

***

### How It Works

#### 1. Define Bundle Components

Each bundle consists of:

* **Required products**
* Optional **shared components** (common across multiple bundles)

Example:

* Shared components:
  * Hydrogen (Qty: 1)
  * Oxygen (Qty: 1)
* Bundle-specific item:
  * Liquid (Qty: 1)

***

#### 2. Set Bundle Pricing

You can assign:

* A **fixed bundle price** (e.g., ₹100 for the full bundle)
* Or a **percentage discount**

***

#### 3. Create Multiple Bundles

You can create multiple bundles using the same shared components.

Example:

* **Liquid Bundle**
  * Hydrogen + Oxygen + Liquid → ₹100
* **Snowboard Bundle**
  * Hydrogen + Oxygen + Snowboard → ₹200

***

#### 4. Configure Priority

When multiple bundles can be formed from the same cart, **priority determines which bundle is applied first**.

* Higher priority bundles are applied first
* Lower priority bundles are ignored if items are already consumed

You can adjust priority using the **arrow controls** in the UI.

***

### Example Scenarios

#### Scenario 1: Single Bundle Application

Cart contains:

* Liquid + Hydrogen + Oxygen

Result:

* Bundle is formed
* Total price becomes ₹100

***

#### Scenario 2: Competing Bundles

Cart contains:

* Liquid + Hydrogen + Oxygen
* Snowboard + Hydrogen + Oxygen

If **Liquid Bundle has higher priority**:

* Liquid bundle is applied
* Snowboard bundle is ignored

If **Snowboard Bundle has higher priority**:

* Snowboard bundle is applied
* Liquid bundle is ignored

***

#### Scenario 3: Multiple Bundle Formation

Cart contains:

* 2× Hydrogen
* 2× Oxygen
* 1× Liquid
* 1× Snowboard

Result:

* Both bundles can be formed:
  * Liquid bundle → ₹100
  * Snowboard bundle → ₹200
* Total = ₹300

***

### Repetition Control

You can configure how many times a bundle can be applied:

* Limited repetitions
* Unlimited repetitions

If unlimited, bundles will continue forming as long as required items exist in the cart.

***

### When to Use This Feature

This feature is ideal when:

* You need **precise control over bundle composition**
* Bundles share **common components**
* You operate in a **POS environment**
* You want to avoid **cart-level discount inconsistencies**
* You manage **large or complex bundle catalogs**

***

### Important Notes

* Bundles are applied **only when all required items are present**
* Items used in one bundle **cannot be reused** in another (unless quantities allow)
* **Priority order directly impacts discount outcomes**
* Changes in cart (adding/removing items) will **re-evaluate bundle application**

***

### Summary

The Bundle Discounts feature enables powerful, flexible bundling by:

* Combining products at a granular level
* Supporting shared components
* Using priority-based logic for conflict resolution

This makes it highly effective for **retail, POS systems, and complex product combinations**.


---

# 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.dollarlabs.io/dollarlabs-ultimate-discounts/bundle-discount.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.