diff --git a/documentation/build/discount-types-and-effects.mdx b/documentation/build/discount-types-and-effects.mdx index 247e18d8d..e00a2a4aa 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,16 @@ 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 items in the cart. + +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 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. diff --git a/documentation/build/product-bundles.mdx b/documentation/build/product-bundles.mdx index dc7fa90f1..c1577c71f 100644 --- a/documentation/build/product-bundles.mdx +++ b/documentation/build/product-bundles.mdx @@ -135,6 +135,34 @@ All free products are multiplied by the number of bundles. +### Free products: Add same items as ordered + +**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**. + +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. + + +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 "Socks" +- **Multiply discount by each bundle added** + +**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. + + + ### 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.