# How to set up

### What is Bundle Builder? 

Bundle Builder is a powerful feature that allows you to create customizable bundle offers with tiered discounts. Customers can mix and match selected products, and automatically unlock increasing discounts as they add more items to their cart.

### Why to use Bundle Builder? 

<details>

<summary>Increase Average Order Value (AOV)</summary>

Tiered discounts incentivize shoppers to buy more items in a single order.

</details>

<details>

<summary>Allow personalized offers</summary>

Let customers mix & match selected products rather than forcing fixed bundles.

</details>

<details>

<summary>Give real-time motivation </summary>

Visual progress bar and dynamic messaging push customers to reach the next discount tier, thus improving bundle completion rate.

</details>

### How to set up:&#x20;

#### Step 1: Navigate Bundle Builder feature

Go to **Offers** tab on the app menu > Choose **Create new offer** > Click **Create** on the **Bundle Builder** card.

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

#### Step 2: Set up offer information

**Offer information**&#x20;

Enter a name in **Campaign name** (internal use only)

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

#### Step 3: Configure Trigger Conditions&#x20;

This is where you define which products customers can include in their bundle. Notice that Collections are not supported, so you must select individual products or variants.

**Applicable products**

Type the name of a product you want to add. If you prefer to view and scroll through all products, use the **Browse** button.

{% hint style="success" %}
You can add up to **15 products or variants**.
{% endhint %}

<figure><img src="/files/9PL1aO9tK78HB2SNJtDS" alt=""><figcaption></figcaption></figure>

#### Step 4: Configure Discount settings

This step allows you to set up tiered discount levels based on the number of products customers add to their bundle.

**Discount type**

Choose the discount type: Percentage or Fixed amount

**Set up offer tier**

Add the number of product required in each tier and its corresponding discount value.&#x20;

Click **+ Add box** to create more discount levels.&#x20;

{% hint style="warning" %}
The system supports up to 5 tiers only, as more than that risks cluttering the widget and confusing customers.
{% endhint %}

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

#### Step 5: Customize the Widget display&#x20;

{% stepper %}
{% step %}
Adjust the frontend display messages shown on the bundle widget.&#x20;

There are some fields that you are allowed to customize, which are:&#x20;

* Title: The heading of the bundle widget.
* Promotion message: A dynamic message that introduces the discount opportunity based on the first tier.
* Progress message: A motivational message that encourages customers to add more items to unlock the next tier.
* Promotion reached message: A success message that confirms the customer has unlocked a discount. Reinforces urgency and satisfaction.
  {% endstep %}

{% step %}
Insert dynamic placeholders (variables) in your messages to make them adapt based on real-time customer interaction.

* {{trigger\_amount}}: Shows the number of items needed to unlock a discount tier
* {{value\_discount}}: Shows the discount percentage available for the current or upcoming tier
* {{remaining\_item}}: Shows how many more items are needed to reach the next tier
  {% endstep %}

{% step %}
Add translations (optional)

If you serve customers in multiple languages, you can translate your widget text.

* Click the **Translation** button.
* A pop-up window will appear (like in the screenshot).
* From the dropdown, select your target language (e.g., German, French, Spanish).
* Enter translated text for each field
* Click **Add** to save translations.
  {% endstep %}
  {% endstepper %}

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

#### Step 6: Set the Schedule&#x20;

Set the **Start date and time** for when your bundle will go live.

Optional: Add an **End date** if it’s a limited-time campaign by ticking **Set end date** box.

#### Final step: Save and launch your bundle campaign

{% stepper %}
{% step %}

#### Set the status into Active

From the **Status** dropdown (top-right panel), make sure it’s set to **Active.** Only active campaigns will appear on the storefront.
{% endstep %}

{% step %}

#### Recheck all the information

Double-check all required fields to see if you are sure with all the set up or not. Use the **Summary** panel (on the right) to confirm Selected products and Conditions of the bundle.&#x20;

<figure><img src="/files/zngeG1159lMjMH6xtnlm" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Hit the Save button

Find the **Save** button in the top-right corner of the screen.
{% endstep %}

{% step %}

#### Complete steps on the pop up

A popup will appear automatically if this is your first time saving the offer. Follow the steps to set up your theme so that the bundle will appear on your storefront.&#x20;

<figure><img src="/files/75IlOQ3wopKAThdzpaAt" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Congrats! You've done with all the set up. **Bundle Builder** helps you drive more sales by encouraging customers to buy in volume with dynamic tiered discounts. It's flexible, engaging, and fully customizable to fit your store’s look and feel. Happy selling!\~


---

# 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.avada.io/aov-bundle-upsell/bundle-builder/how-to-set-up.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.