A bundle is a group of products, services, or features offered together as a single package. Bundles are often priced lower than the total cost of purchasing each item separately. In Voucherify, bundles work with cart promotions, generic codes, and unique codes. This article describes in detail how bundles work, including bundle multiplication that multiplies discounts and limits based on the number of bundles in the cart.Documentation Index
Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt
Use this file to discover all available pages before exploring further.
Glossary
Bundle
Bundle
A bundle is a group of products, services, or features offered together as a single package. Bundles are often priced lower than the total cost of purchasing each item separately.
Bundled items
Bundled items
Bundled items are the individual products or services that make up a bundle. When a customer buys all required bundled items together, they become eligible for the bundle discount or reward.
Minimum quantity of products
Minimum quantity of products
The minimum quantity of products defines how many items must be included in the bundle for it to qualify for the promotion. If the customer adds fewer items than the minimum, the bundle discount doesn’t apply.
Maximum number of eligible bundles
Maximum number of eligible bundles
The maximum number of eligible bundles sets a cap on how many bundles can be counted in a single order. This limit controls how many times the bundle discount can apply per transaction.
Item discount limit
Item discount limit
We recommend setting an item discount limit in:
- Amount discount: Apply the full discount to each item unit
- New price: Apply the discount to item unit
- Upgrade Bonus: Replace order items
Bundle scaling
Bundle scaling determines whether the discount is applied once or multiplied by the number of eligible bundles in the cart. Use this setting to control how the discount value or limit behaves when multiple bundles are detected.Options
Multiply discount by each bundle added (default)
Multiply discount by each bundle added (default)
The discount scales automatically based on the number of eligible bundles in the cart.
- Discount values (amount or percentage) are multiplied by the number of bundles
- Limits (such as maximum discounted units) are also multiplied accordingly
Don't multiply – use fixed discount
Don't multiply – use fixed discount
The discount is applied once, regardless of how many bundles are in the cart.Choose this option if your formula already includes bundle quantity (e.g.
order.bundle.quantity).- Prevents double multiplication
- Gives full control over how the discount is calculated
Bundle scaling does not apply to the following discount types:
- New price: Apply to whole cart
- New price: Apply the discount to item unit
Buy X, get Y for free
The Buy X, get Y for free discount category has the following types.Free products: Add missing order items to match total discount units count
Free products: Add missing order items to match total discount units count adds only the missing free products. It will match the total defined maximum number of eligible bundles limit.Free products: Add missing order items to match total discount units count – example
Free products: Add missing order items to match total discount units count – example
Example:Buy 1 laptop → get 1 laptop bag free.Buy 2 laptops → get 2 laptop bags free to reach the required total.Result:The number of free products is multiplied by the number of bundles.
Free products: Always add new units items
Free products: Always add new units items always adds new free products. It ignores whether the same product already exists in the cart.Free products: Always add new units items – example
Free products: Always add new units items – example
Example:Buy 1 pair of shoes → get 1 pair of socks free.Buy 3 pairs of shoes → get 3 pairs of socks free, regardless of existing ones.Result:The number of newly added free products is multiplied by the number of bundles.
Free products: Add many order items
Free products: Add many order items adds multiple free products at once when several bundles are qualified.Free products: Add many order items – example
Free products: Add many order items – example
Example:Buy 1 pizza + 1 cola → get 2 free desserts.Buy 2 pizzas + 2 colas → get 4 free desserts.Result:All free products are multiplied by the number of bundles.
Upgrade bonus: Replace order items
Upgrade bonus: Replace order items replaces existing products with upgraded ones. The multiplication applies to both the added and removed items.Upgrade bonus: Replace order items – example
Upgrade bonus: Replace order items – example
Example:Buy 1 small coffee → upgrade to 1 large coffee.Buy 3 small coffees → upgrade to 3 large coffees.Result:The number of replaced and added products is multiplied by the number of bundles.
Discount whole order
The Discount whole order discount category has the following types.Amount discount: Apply to whole cart
Amount discount: Apply to whole cart applies a fixed amount discount to the entire cart. The discount value is multiplied by the number of bundles.Amount Discount: Apply to whole cart – example
Amount Discount: Apply to whole cart – example
Example:$1 discount per bundle (lip balm + hand cream) 5 × lip balms + hand creams → $5 off the whole cart.Result:The discount value is multiplied by the number of bundles and applies to the cart total.
Percent discount: Apply to whole cart
Percent discount: Apply to whole cart applies a percent discount to the entire cart. The percentage value is multiplied by the number of bundles.Percent discount: Apply to whole cart – example
Percent discount: Apply to whole cart – example
Example:5% discount per bundle (cleaning spray + microfiber cloth)5 × cleaning sprays + microfiber cloths → 25% off the whole cart.Result:The percentage discount value is multiplied by the number of bundles and applies to the entire cart.
New price: Apply to whole cart
New price: Apply to whole cart applies a fixed total price for the cart. The discount value is not multiplied.New price: Apply to whole cart – example
New price: Apply to whole cart – example
Example:New total cart price: $50 per bundle (phone case + screen protector) 5x phone cases + screen protectors → $50 total, not multiplied.Result:The discount value is not multiplied by the number of bundles. The total fixed price applies once to the entire cart.
Discount bundle items by fixed amount
The Discount bundle items by fixed amount discount category has the following types.Amount discount: Apply the full discount to each item unit
Amount discount: Apply the full discount to each item unit applies a full discount to each item unit. The number of discounted units is multiplied by the number of bundles. By default, Voucherify automatically assigns the Maximum eligible units per order item limit to 1. Without a limit, each eligible unit receives the discount, regardless of how many bundles are in the order.Amount discount: Apply the full discount to each item unit – example
Amount discount: Apply the full discount to each item unit – example
Example:Laptop + bag, get $20 off for a single mouseCart 1: Limit setBundle: Laptop + BagDiscounted product: Mouse collectionDiscount rule: Maximum eligible units per order item limit set to 1Cart contents:Laptop × 2 Bag × 2 Mouse × 3 – $40 totalExplanation:The cart contains two complete bundles (Laptop + Bag × 2). Each bundle qualifies for one discounted mouse because the discount limit is set to one per bundle. Only two mice receive the discount, giving the customer a total discount of 2 × 40. The third mouse remains at full price.Cart 2 – No Limit SetBundle: Laptop + BagDiscounted product: Mouse collectionDiscount rule: No maximum eligible units per order item limit setCart contents:Laptop × 2 Bag × 2 Mouse × 3 – $60 totalExplanation:The cart again includes two complete bundles (Laptop + Bag × 2). Because there is no limit on the number of discounted items, all three mice receive the discount, so it’s $60 in total. The rule applies to every matching product in the cart, not just one per bundle.Result:The discount value remains the same per unit item. The number of max discounted units is multiplied by the number of bundles.
Amount discount: Apply the discount to item subtotal
Amount discount: Apply the discount to item subtotal applies a fixed discount to the subtotal of each targeted product. The discount value is multiplied by the number of bundles.Amount discount: Apply the discount to item subtotal – example
Amount discount: Apply the discount to item subtotal – example
Example:Bundle: Laptop + bag, get $20 off for a mouse collection productCart 1: Combined mouse order lineBundle: Laptop + BagDiscounted product: Mouse collectionDiscount rule: $20 for each bundleCart contents:Laptop × 2 Bag × 2 Mouse × 3 (one order line) $40 discountExplanation:The cart includes two complete bundles (Laptop + Bag × 2), making the customer eligible for a $40 subtotal discount. Because all three mice are grouped in a single order line, the discount is applied once to that line’s subtotal. Cart 2: Split mouse order linesBundle: Laptop + BagDiscounted product: Mouse collectionDiscount rule: Subtotal discount applies separately to each order lineCart contents:Laptop × 2 Bag × 2 Mouse × 1 $40 discountMouse × 1 $40 discountMouse × 1 (three separate order lines) $40 discountExplanation:The cart again includes two complete bundles (Laptop + Bag × 2). Because each mouse is on a separate order line, the discount is applied individually to each line. Each mouse line receives a $40 discount, resulting in a total of $120 off.Result:The discount value is multiplied by the number of bundles and applied to the subtotal of each targeted item.
Discount percentage off bundle items
The Discount percentage off bundle items discount category has the following types.Percent discounts (item level)
Percent discounts (item level) applies a percentage discount to targeted items. The discount percent is multiplied by the number of bundles.Percent discounts (item level) – example
Percent discounts (item level) – example
Example:5% per bundle (2 packs of crisps) 4x packs of crisps → 10% off all soda drinks in the targeted collection.Result:The discount value is multiplied by the number of bundles. The maximum number of discounted units is not multiplied.
Set price for bundle items
The Set price for bundle items discount category has the following types.New price: Apply the discount to item unit
New price: Apply the discount to item unit sets a new price for selected items. The value does not multiply, but the number of affected items multiplies by the number of bundles.New price: Apply the discount to item unit – example
New price: Apply the discount to item unit – example
Example:Set price: $10 per ticket, $2 per drink Maximum eligible units per order item limit set to: 1 ticket and 2 drinks per bundle.2 bundles = up to 2 tickets at $10 and 4 drinks at $2 discounted.Result:The discount value is not multiplied by the number of bundles. The number of affected products is multiplied by the number of bundles.
Split discount between bundle items
The Split discount between bundle items discount category has the following types.Amount discount: Split the discount proportionally to amount
Amount discount: Split the discount proportionally to amount splits the discount proportionally based on the subtotal of each item. The discount value is multiplied by the number of bundles.Amount discount: Split the discount proportionally to amount
Amount discount: Split the discount proportionally to amount
Example:Bundle: Coffee Machine + GrinderDiscounted products: Coffee Beans + Filter PackCart contents:Coffee Machine × 2 Grinder × 2 Coffee Beans – $30 (60% of the discounted amount) Filter Pack – $20 (40% of the discounted amount)Explanation:The discount is $10 per bundle. With two bundles, the customer gets $20 off in total. The discount is split proportionally — Coffee Beans receive $12 (60%) and the Filter Pack receives $8 (40%).The allocation is based on the subtotal of all targeted order line items, not just the items within a single bundle.Result:The discount value is multiplied by the number of bundles and split proportionally across the targeted order line items based on their subtotal value.
Amount discount: Split the discount proportionally to quantity
Amount discount: Split the discount proportionally to quantity splits the discount proportionally by product quantity. The discount value is multiplied by the number of bundles.Amount discount: Split the discount proportionally to quantity
Amount discount: Split the discount proportionally to quantity
Example:Bundle: Tennis Racket + Sports BagDiscounted products: Tennis Balls + WristbandsCart contents:Tennis Racket × 2 Sports Bag × 2 Tennis Balls × 3 (60% of the discounted quantity) Wristbands × 2 (40% of the discounted quantity)Explanation:The discount is $10 per bundle. With two bundles, the customer qualifies for a $20 total discount. The discount is split based on quantity — Tennis Balls (3 units) receive $12 (60%), and Wristbands (2 units) receive $8 (40%).Result:The discount value is multiplied by the number of bundles and split proportionally by quantity.