---
title: Bundle Discounts
description: "Bundle Discounts (Pro) let you define a required set of products and apply a discount only when customers buy the complete set together. --- ## What Bundle Discounts Do - Require all selected bundle products in the cart before discount…"
url: "https://webstepper.io/docs/smart-cycle-discounts/discount-types/bundle-discounts/"
updated: "2026-02-17"
category: Discount Types
---

# Bundle Discounts

Bundle Discounts (Pro) let you define a required set of products and apply a discount only when customers buy the complete set together.

---

## What Bundle Discounts Do

- Require all selected bundle products in the cart before discount applies
- Support 3 pricing modes: percentage, fixed amount, flat bundle price
- Handle quantity-based carts (multiple complete bundle sets)
- Apply only to eligible bundle quantities when cart quantities are uneven

**Pro-only:** Bundle discount type is available in Smart Cycle Discounts Pro.

---

## When to Use Bundle Discounts

- **Starter kits:** Main product + required accessories
- **Cross-sell bundles:** Frequently bought together items
- **Gift sets:** Seasonal or themed multi-item offers
- **Inventory balancing:** Pair slower items with stronger sellers

---

## Setup (Wizard Step 3)

### 1) Choose Discount Type: Bundle Deals

In Step 3 (Discount Configuration), select **Bundle Deals**.

### 2) Select Bundle Products

- Select at least **2** products
- Customers must have all selected products in cart to qualify
- If any required product is missing, no bundle discount is applied

### 3) Choose Bundle Pricing Mode

- **Percentage Off** (e.g. 15% off each bundle item)
- **Fixed Amount Off** (e.g. $5 off each bundle item)
- **Fixed Bundle Price** (e.g. all selected items together for $49.99)

### 4) Set Discount Value

- Value must be greater than 0
- Percentage mode allows up to 100%
- Flat bundle price must be a positive amount

---

## How Quantity Matching Works

Bundle matching is quantity-aware. The plugin computes how many complete sets exist in cart.

**Example bundle:** A + B + C

- If cart has A×2, B×2, C×2 → 2 complete sets, all units eligible
- If cart has A×3, B×2, C×2 → 2 complete sets; only 2 units of A get bundle pricing
- If cart has A×2, B×2, C×1 → 1 complete set; only 1 unit each gets bundle pricing

When only part of a product’s quantity is eligible, pricing is blended so eligible units get bundle pricing and extra units remain regular price.

---

## Pricing Modes Explained

### Percentage Off

Each eligible bundle item is discounted by the selected percentage.

**Example:** 20% off each item in a 3-item bundle.

### Fixed Amount Off

A fixed value is subtracted from each eligible bundle item (never below 0).

**Example:** $5 off each eligible bundle item.

### Fixed Bundle Price

One total target price for the full bundle set. The plugin distributes that total proportionally across bundle items based on regular prices.

**Example:** If regular prices are $60 + $30 + $10 (total $100) and flat bundle price is $80:

- Item 1 share: 60%
- Item 2 share: 30%
- Item 3 share: 10%
- Discounted shares become approximately $48, $24, $8

---

## Validation Rules

- Bundle config is required for bundle campaigns
- Minimum 2 bundle products
- Valid discount type required: `percentage`, `fixed`, or `flat_price`
- Discount value must be positive
- Percentage cannot exceed 100%

---

## Product & Variation Notes

- Bundle matching supports WooCommerce product quantities in cart
- Variation/parent relationships are considered so bundle definitions remain practical for variable products
- Use real catalog products (published and purchasable) for stable behavior

---

## Interaction with Other Campaign Rules

- Campaign priority still determines winner when overlaps happen
- Bundle discounts are treated as complex discounts in health/performance checks
- High-frequency rotation with complex discounts can trigger performance warnings

---

## Health & Safety Checks

Campaign Health flags bundle-risk scenarios such as:

- Too few products in bundle
- Very high percentage bundle discounts
- Extreme discount configurations that may hurt margin

---

## Troubleshooting

### “Bundle discount not applying”

- Confirm all bundle products are in cart at the same time
- Check quantities: incomplete sets won’t fully qualify
- Check campaign status/schedule and priority overlaps
- Clear cache after large campaign or product updates

### “Only some quantities discounted”

This is expected when cart quantities form partial sets. Only complete-set quantities get bundle pricing.

### “Flat bundle price looks uneven per item”

Expected behavior: flat bundle pricing is proportionally distributed by item regular prices.

---

## Best Practices

- Keep bundles easy to complete (2-4 products is usually ideal)
- Name campaigns clearly (e.g., “Camera + Lens + Bag Bundle”)
- Use flat bundle price when you want one clear marketing headline
- Test on staging with mixed quantities before going live
- Set intentional priority if other campaigns may target same products
