> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.widebundle.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Getting started with WideBundle 🚀

# Welcome to WideBundle! 👋

We’re thrilled to have you on board!  
This guide will help you install, configure, and customize WideBundle step by step so you can start increasing your average order value right away.

💡 Prefer watching instead?  

${frame}[](https://www.loom.com/embed/d27ffd88a91745a4b047c986b6d88584?sid=d3a4a2fa-672c-4a6f-a434-c4b9497555a1)

---

## 1. Activate WideBundle in Your Theme

Before you can create and display your bundles, the WideBundle widget must be activated in your theme.

1. Open the app and click **Activate WideBundle**

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1c0242q.png)

2. You’ll be redirected to your **Shopify theme editor**
3. On the left sidebar, make sure **WideBundle** is checked
4. Click **Save** at the top right corner

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_14469dl.png)

5. Go back to WideBundle — you’ll now see that your app is **activated**

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_8cp0ab.png)

Your widget is now live and ready to appear on your product pages.

---

## 2. Create Your First Bundle

Now that WideBundle is activated, let’s create your first bundle.

1. Scroll down and click **Add Bundles**

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_13op8dd.png)

2. Choose the **bundle type**

We recommend using **Standard Bundles** — that’s the default and the one used in 99% of cases.  
Only use **Variant Bundles** if you have a very specific advanced setup where each bundle must generate a unique SKU.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1x97y8w.png)

3. Select where your offers should appear:
* On a **specific product**, or  
* On **all products in a collection**

By default, the most recently added product will already be preselected.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_17a8qyp.png)

---

## 3. Configure Your Offers and Design

The left side of your screen is where you configure your offers and design.  
The right side is a live preview that updates in real time.

---

### Step 1 — Header

* Add a **title** above your bundles (for example: *“Choose your bundle”*)
* If your product is featured on your homepage, check the option **Product Featured** so the widget also appears there.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1ycwhhn.png)

---

### Step 2 — Offers

By default, three offer blocks are created. Each one represents a different deal your customers can select.

* Click on any block to edit it  
* You can **add** or **remove** bundles anytime

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1tb74bq.png)

#### Configure each offer:
1. **Title** – name your offer (e.g., “Buy 2 T-Shirts”)
2. **Image (optional)** – add a thumbnail for visual clarity
3. **Products** – choose which products are part of the bundle and their quantity

For example, you can create a bundle with *2 T-Shirts* or *1 T-Shirt + 1 Pants*.  
Each product’s price updates automatically in the preview.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1rh7khx.png)

---

### Step 3 — Discounts

Select how you want to apply discounts:

* **Percentage discount** (e.g., 10% off)  
* **Fixed amount** (e.g., $20 off)  
* **Set price** (e.g., bundle price = $30)

You’ll immediately see the new total update in the preview.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1a23swj.png)

---

### Step 4 — Gifts (Free Products)

You can include **gifts** in your bundle to increase perceived value.

1. Click **Add Gift**
2. Select which product to offer (e.g., a bracelet)
3. Add a thumbnail and customize the label (e.g., “Free bracelet”)
4. Choose where the gift appears:
* **Inside the bundle card**, or  
* **Below all bundles** (to create a “rewards unlocked” effect)

You can even make higher bundles unlock additional gifts — perfect for gamifying the buying experience.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_146wzgv.png)

---

### Step 5 — Advanced Settings

#### Color Swatches
Replace dropdowns with color circles for options like “Color” or “Size.”  
[Learn more about color swatches](https://help.widebundle.com/en/article/how-to-use-swatches-color-34zpcs/)

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_thksgt.png)

#### Price per Unit
Display a price per unit (e.g., “$10 per item”) for better clarity.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1ydqt9k.png)

#### Custom Sentences
Highlight your best offers with short custom sentences like *“Best Offer”* or *“Most Popular.”*

You can position them anywhere (above, diagonal, corner, etc.)

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_n2kgmh.png)

#### Preselect an Offer
You can preselect a bundle by default — ideal for directing customers to your best deal.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_1eod9nc.png)

---

### Step 6 — Customize the Design

Inside the **Design tab**, you can personalize everything in real time while editing your offers:

1. **Widget Theme** – choose between Minimal, Solid, or Classic  
2. **Colors** – change button backgrounds, card colors, text, and highlights  
3. **Texts** – adjust font size, weight, and style  
4. **Shapes** – modify rounded corners and image sizes  
5. **Text Content** – change button labels, savings messages, etc.  
6. **General Options** – define what happens when clicking “Add to cart” (open drawer, go to cart, or go to checkout)

All changes are instantly reflected in the live preview.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_16n9o2g.png)

---

### Step 7 — Save and Publish

Once your offers and design are ready, click **Create Bundles** at the top.  
You’ll be redirected to the main dashboard, and your bundles will automatically appear on your store.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_ychoem.png)

---

## 4. Preview Your Bundle

To make sure everything looks perfect:
1. Click **Preview** or open your product page manually  
2. You’ll see your WideBundle widget live on your store  
3. Add an offer to your cart — all discounts and gifts will be applied automatically at checkout

![](https://storage.crisp.chat/users/helpdesk/website/-/5/9/d/0/59d08aea42fadc00/image_poi6ui.png)

---

## 🎉 You’re All Set!

Your WideBundle setup is complete!  
Customers can now easily select bundles, enjoy discounts, and receive their gifts directly in their cart.

### Need Help?

* Use the **chat bubble** at the bottom right of the app for support  
* Browse more tutorials on our [Help Center](https://help.widebundle.com)

Welcome to the WideBundle family — let’s boost your sales together 🚀
