From 00677a3c9d43c83f57f18dae514bb0879a72dd2f Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Tue, 14 Apr 2026 13:45:20 +0200 Subject: [PATCH 1/3] Add same items as ordered --- documentation/build/product-bundles.mdx | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/documentation/build/product-bundles.mdx b/documentation/build/product-bundles.mdx index dc7fa90f1..79a6e20c8 100644 --- a/documentation/build/product-bundles.mdx +++ b/documentation/build/product-bundles.mdx @@ -135,6 +135,31 @@ All free products are multiplied by the number of bundles. +### Free products: Add same items as ordered + +This discount type calculates the number of free units based on purchased items, but you must explicitly define where the free units should be applied using **Discounted products**. + + +Free items are not automatically assigned to the same products that triggered the bundle — they are applied only within the scope you define. + + + +When used with **Multiply discount by each bundle added** and broad product collections, the number of free products can increase quickly. + + + + +- **Bundled items:** Collection "T-Shirts", minimum quantity = 1 +- **Discount type:** Free products → Add same items as ordered +- **Free units:** 1 +- **Discounted products:** Collection "T-Shirts" +- **Multiply discount by each bundle added** + +**Result** +- Customer buys 3 T-shirts → gets 3 free T-shirts + + + ### 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. From 9a845e4420e5f2240d39dc3eec532c75439c6ea0 Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Tue, 14 Apr 2026 16:10:56 +0200 Subject: [PATCH 2/3] Update discount-types-and-effects.mdx --- documentation/build/discount-types-and-effects.mdx | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/documentation/build/discount-types-and-effects.mdx b/documentation/build/discount-types-and-effects.mdx index 247e18d8d..cd47b00a9 100644 --- a/documentation/build/discount-types-and-effects.mdx +++ b/documentation/build/discount-types-and-effects.mdx @@ -69,6 +69,7 @@ Campaign Manager supports order discount, products discount, rewards, and free s - **Free products**: Add missing order items to match total discount units count - **Free products**: Always add new units items - **Free products**: Add many order items + - **Free products**: Add same items as ordered - **Upgrade bonus**: Replace order items - **Free Shipping** - **Free products**: Add missing order items to match total discount units count @@ -370,6 +371,12 @@ For example, the code adds two free t-shirts: This effect adds multiple items to the cart, each with a custom effect: either [Add missing order items to match total discount units count](#add-missing-order-items-to-match-total-discount-units-count) or [Always add new units items](#always-add-new-units-items). +### Add same items as ordered + +This effect calculates the number of free units based on purchased items, but you must explicitly define where the free units should be applied. + +The free items are applied only within the scope defined in **Discounted products**. They are not automatically assigned to the same products that triggered the discount. + ### Upgrade Bonus: Replace order items This effect replaces one order item or an order item from a selected collection with another order item in the defined quantity per replaced unit. From 267dbe263906da6248ee64f514aaa61f09a10344 Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Wed, 15 Apr 2026 17:11:20 +0200 Subject: [PATCH 3/3] Same items --- .../build/discount-types-and-effects.mdx | 8 +++++-- documentation/build/product-bundles.mdx | 21 +++++++++++-------- 2 files changed, 18 insertions(+), 11 deletions(-) diff --git a/documentation/build/discount-types-and-effects.mdx b/documentation/build/discount-types-and-effects.mdx index cd47b00a9..e00a2a4aa 100644 --- a/documentation/build/discount-types-and-effects.mdx +++ b/documentation/build/discount-types-and-effects.mdx @@ -373,9 +373,13 @@ This effect adds multiple items to the cart, each with a custom effect: either [ ### Add same items as ordered -This effect calculates the number of free units based on purchased items, but you must explicitly define where the free units should be applied. +This effect calculates the number of free units based on items in the cart. -The free items are applied only within the scope defined in **Discounted products**. They are not automatically assigned to the same products that triggered the discount. +Use it to reward selected products or product collections without defining each free item separately. + +Voucherify checks which cart items match the discount configuration, calculates the number of free units, and applies them to the products selected in **Discounted products**. + +The free units are not automatically assigned to the same items that triggered the calculation. ### Upgrade Bonus: Replace order items diff --git a/documentation/build/product-bundles.mdx b/documentation/build/product-bundles.mdx index 79a6e20c8..c1577c71f 100644 --- a/documentation/build/product-bundles.mdx +++ b/documentation/build/product-bundles.mdx @@ -137,26 +137,29 @@ All free products are multiplied by the number of bundles. ### Free products: Add same items as ordered -This discount type calculates the number of free units based on purchased items, but you must explicitly define where the free units should be applied using **Discounted products**. +**Free products: Add same items as ordered** calculates the number of free units based on items in the cart, and applies them to the products selected in **Discounted products**. - -Free items are not automatically assigned to the same products that triggered the bundle — they are applied only within the scope you define. - +The free units are calculated per matching item in the cart, but they are not automatically assigned to those same items. + +Use this option when you want to calculate free units from cart items while controlling exactly which products or collections receive the discount. -When used with **Multiply discount by each bundle added** and broad product collections, the number of free products can increase quickly. +Be careful when using **Multiply discount by each bundle added** with broad product collections or high quantities — the number of free products can increase quickly. - + + +**Example:** - **Bundled items:** Collection "T-Shirts", minimum quantity = 1 - **Discount type:** Free products → Add same items as ordered - **Free units:** 1 -- **Discounted products:** Collection "T-Shirts" +- **Discounted products:** Collection "Socks" - **Multiply discount by each bundle added** -**Result** -- Customer buys 3 T-shirts → gets 3 free T-shirts +**Result**: + +A customer who adds 3 T-shirts to the cart gets 3 socks discounted as free, as long as **Maximum number of eligible bundles** is set to at least 3.