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