Bundle Discounts
2 min read
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, orflat_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
