Understanding Bundle Pricing in the Test Tool

Bundle pricing is a promotional strategy where customers receive a discount when they buy a specific number of items together. The Test Promotional Pricing tool includes a dedicated bundle mode that lets you simulate these deals and understand exactly how the pricing engine handles complete bundles, multiple bundles, and leftover items.

What Is Bundle Pricing

Bundle pricing groups a fixed number of items together at a discounted price. For example, "Buy 3 for $20" means any three qualifying items cost $20 total instead of the sum of their individual prices. This encourages customers to buy more units per transaction, increasing sales volume while giving the customer a perceived deal.

Unlike standard quantity-range discounts (which apply a per-unit discount within a range), bundle pricing treats a group of items as a single priced unit. The distinction matters when the customer buys a quantity that is not an exact multiple of the bundle size.

Enabling Bundle Mode

Check the Is Bundle checkbox on the Test Promotional Pricing form. When enabled, the interface changes to show bundle-specific fields:

• Bundle Quantity replaces the Quantity From field. This is the number of items required to form one complete bundle.
• Allow Multiple Times checkbox appears. This controls whether the bundle discount applies once or repeats for every complete bundle in the purchase.
• The Quantity To field is hidden because bundle pricing does not use an upper quantity limit in the same way as standard discounts.

The discount type radio buttons (Special Price, Discount Amount, Discount Percentage) still apply in bundle mode. They determine how the per-unit price is calculated within each bundle.

Bundle Quantity

The Bundle Quantity field specifies how many items must be purchased together to form one bundle. For a "Buy 3 for $20" deal, the bundle quantity is 3. For a "Buy 5, get the group at 20% off" deal, the bundle quantity is 5.

The tool divides the total quantity entered by the bundle quantity to determine how many complete bundles the customer is purchasing and how many items are left over.

Allow Multiple Times

The Allow Multiple Times checkbox controls whether the bundle discount repeats for every complete bundle or applies only once.

When Enabled (Checked)

The bundle discount applies for every complete bundle in the purchase. If the bundle quantity is 3 and the customer buys 9 items, that is 3 complete bundles, and each bundle receives the discounted price.

Example: Item price $10.00, bundle quantity 3, special price $8.00 per unit, customer buys 9 items.

• 9 divided by 3 = 3 complete bundles, 0 remaining items
• 3 bundles x 3 items x $8.00 = $72.00
• Regular price would be 9 x $10.00 = $90.00
• Customer saves $18.00

When Disabled (Unchecked)

Only the first complete bundle receives the discount. All remaining items, including items that could form additional bundles, are charged at the regular per-unit price.

Example: Same scenario — item price $10.00, bundle quantity 3, special price $8.00 per unit, customer buys 9 items.

• 1 bundle of 3 items at $8.00 = $24.00
• 6 remaining items at $10.00 = $60.00
• Total = $84.00 (vs. $90.00 regular, saves $6.00)

The difference is significant: $72.00 with multiple bundles versus $84.00 with a single bundle. Choose carefully based on how aggressive you want the promotion to be.

How Remaining Items Work

When the customer buys a quantity that is not an exact multiple of the bundle quantity, the leftover items are always charged at the regular per-unit price. This applies regardless of the Allow Multiple Times setting.

Example: Item price $10.00, bundle quantity 3, special price $7.00 per unit, customer buys 5 items, Allow Multiple Times enabled.

• 5 divided by 3 = 1 complete bundle, 2 remaining items
• 1 bundle: 3 items at $7.00 = $21.00
• 2 remaining items at $10.00 = $20.00
• Total = $41.00 (vs. $50.00 regular, saves $9.00)

Same example with Allow Multiple Times disabled:

• 1 bundle: 3 items at $7.00 = $21.00
• 2 remaining items at $10.00 = $20.00
• Total = $41.00 (same result because there is only 1 complete bundle either way)

The Allow Multiple Times setting only makes a difference when the quantity is large enough to form two or more complete bundles.

Breakdown Display for Bundles

When bundle mode is active, the breakdown explanation in the text area below the results shows a detailed split:

• "N complete bundles of X items at $Y per bundle" — Shows how many bundles were formed and the discounted cost of each bundle.
• "Z remaining items at $P each" — Shows how many items did not fit into a complete bundle and their regular price.

This makes it transparent exactly how the total was calculated. There is no hidden math — the breakdown accounts for every unit in the purchase.

Testing Different Quantities

To fully understand how a bundle deal will work in practice, test several different quantities:

• Below the bundle threshold — Enter a quantity less than the bundle quantity (e.g., 2 when bundle quantity is 3). The breakdown should show that no bundle is formed and all items are at regular price.
• Exactly one bundle — Enter a quantity equal to the bundle quantity. Verify the discount matches your expectation.
• Exact multiples — Enter quantities that are exact multiples of the bundle quantity (e.g., 6, 9, 12 when bundle quantity is 3). With Allow Multiple Times enabled, every item should receive the bundle discount.
• Non-even amounts — Enter quantities that leave remainders (e.g., 5, 7, 10 when bundle quantity is 3). Verify that leftover items are charged at full price and the total makes sense.

Example Scenarios

Scenario 1: Multiple Bundles Enabled

Item price $10.00, bundle quantity 3, special price $8.00 per unit, customer buys 7 items, Allow Multiple Times enabled.

• 7 divided by 3 = 2 complete bundles (6 items), 1 remaining item
• 2 bundles: 6 items at $8.00 = $48.00
• 1 remaining item at $10.00 = $10.00
• Total = $58.00 (vs. $70.00 regular, saves $12.00)

Scenario 2: Multiple Bundles Disabled

Same setup but Allow Multiple Times is unchecked.

• 1 bundle: 3 items at $8.00 = $24.00
• 4 remaining items at $10.00 = $40.00
• Total = $64.00 (vs. $70.00 regular, saves $6.00)

Scenario 3: Percentage Discount Bundle

Item price $15.00, bundle quantity 4, discount percentage 20%, customer buys 10 items, Allow Multiple Times enabled.

• Discounted per-unit price: $15.00 x 0.80 = $12.00
• 10 divided by 4 = 2 complete bundles (8 items), 2 remaining items
• 2 bundles: 8 items at $12.00 = $96.00
• 2 remaining items at $15.00 = $30.00
• Total = $126.00 (vs. $150.00 regular, saves $24.00)

Scenario 4: Below Bundle Threshold

Item price $10.00, bundle quantity 3, special price $8.00 per unit, customer buys 2 items.

• 2 is less than the bundle quantity of 3 — no bundle is formed
• 2 items at regular price $10.00 = $20.00
• No discount applied
• The breakdown displays in orange-red text indicating the quantity is below the bundle threshold