From fb5f1de9094cf94deeb35dd4b997159198b7b28f Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Wed, 11 Feb 2026 15:05:00 +0100 Subject: [PATCH 1/5] BOGO --- documentation/docs.json | 3 +- documentation/prepare/bogo-scenarios.mdx | 171 +++++++++++++++++++++++ 2 files changed, 173 insertions(+), 1 deletion(-) create mode 100644 documentation/prepare/bogo-scenarios.mdx diff --git a/documentation/docs.json b/documentation/docs.json index 32d0950ba..de1edf914 100644 --- a/documentation/docs.json +++ b/documentation/docs.json @@ -184,7 +184,8 @@ "group": "Products", "pages": [ "prepare/products", - "prepare/product-collections" + "prepare/product-collections", + "prepare/bogo-scenarios" ] }, "prepare/orders", diff --git a/documentation/prepare/bogo-scenarios.mdx b/documentation/prepare/bogo-scenarios.mdx new file mode 100644 index 000000000..1598d0d16 --- /dev/null +++ b/documentation/prepare/bogo-scenarios.mdx @@ -0,0 +1,171 @@ +--- +title: "Create BOGO Scenarios" +description: "A tutorial on setting up Buy One Get One (BOGO) campaigns in Voucherify." +--- + +BOGO campaigns reward customers when they buy selected products. + +In Voucherify, BOGO is configured using the **Bundles** discount category. +You define which products must be in the cart (**Buy X**) and which products are rewarded (**Get Y**). + +BOGO campaigns are commonly used for: + +- buy one, get one free +- buy 2, get 1 free +- buy from one collection, get a gift +- free items with value limits + +## Key concepts + +- **Buy X**: Products the customer must purchase. +- **Get Y**: Products the customer receives for free. +- **Minimum quantity**: How many items are required to trigger the reward. +- **Item discount limit**: Controls how many reward units are added per bundle. + +## BOGO scenarios + +Follow these step-by-step examples to configure popular BOGO offers. + +### Scenario 1: Basic BOGO (Buy one, get one free) + +If a customer buys one **Small Cappuccino**, they get a second one for free. + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select **Small Cappuccino** and set the minimum quantity to **1**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select **Small Cappuccino** again and set the unit quantity to **1**. + + + + Save the campaign. + + When the code is applied, Voucherify adds the second cappuccino at **$0**. + + + +### Scenario 2: Buy 2, get 1 free + +If a customer buys 2 items, they receive 1 extra unit for free. + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select the required product and set the minimum quantity to **2**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select the same product and set the unit quantity to **1**. + + + + Save the campaign. + + Voucherify adds 1 free unit when the customer buys at least 2. + + + +### Scenario 3: Buy from one collection, get a free gift + +If a customer buys at least one item from a collection, they receive a free gift product. + +Example: + +- Buy any product from **Audiophile Zone** +- Get a free product from **Gift Collection** + + + + Start a **Discount Coupon** campaign. + + + + In the **Discount value** step, choose: + + **Bundles > Buy X, get Y for free** + + Select the required collection and set the minimum quantity to **1**. + + + + In **Discount effect**, choose: + + **Free products: Always add new units items** + + Select the gift product or collection and set the unit quantity to **1**. + + + + Save the campaign. + + Voucherify adds the free gift when the customer buys from the required collection. + + + +### Scenario 4: BOGO with a value limit (Free items up to $100) + +Customers can receive free products, but the total discount is capped. + +Example: + +- Buy at least one item from Collection A +- Get items from Collection B for free, up to **$100** + + + + In the **Discount value** step, choose: + + **Bundles > Discount percentage off bundle items** + + Select the required collection and set the minimum quantity to **1**. + + + + Choose: + + **Product discount > Percent discount: Apply discount to item subtotal** + + Set the discount to **100%**. + + + + Set the **Maximum discount amount** to **$100**. + + Select the collection that should be discounted. + + + + Save the campaign. + + Voucherify applies free items until the discount reaches the limit. + + + + +Keep BOGO offers simple by clearly defining what the customer must buy (Buy X) and what they receive for free (Get Y). + \ No newline at end of file From 6ead8fa03aba969934a2aff1223411bceb2ac94a Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Thu, 12 Feb 2026 15:15:43 +0100 Subject: [PATCH 2/5] Update bogo-scenarios.mdx --- documentation/prepare/bogo-scenarios.mdx | 75 ++++++++++-------------- 1 file changed, 32 insertions(+), 43 deletions(-) diff --git a/documentation/prepare/bogo-scenarios.mdx b/documentation/prepare/bogo-scenarios.mdx index 1598d0d16..b277aae98 100644 --- a/documentation/prepare/bogo-scenarios.mdx +++ b/documentation/prepare/bogo-scenarios.mdx @@ -1,32 +1,17 @@ --- -title: "Create BOGO Scenarios" -description: "A tutorial on setting up Buy One Get One (BOGO) campaigns in Voucherify." +title: "Create BOGO scenarios" +description: "Step-by-step guide to setting up Buy One Get One (BOGO) campaigns in Voucherify" +keywords: ['BOGO', 'buy one get one', 'bundles tutorial', 'cart promotions'] --- -BOGO campaigns reward customers when they buy selected products. +BOGO (Buy One Get One) campaigns reward customers when they buy selected products. -In Voucherify, BOGO is configured using the **Bundles** discount category. -You define which products must be in the cart (**Buy X**) and which products are rewarded (**Get Y**). +In Voucherify, BOGO offers are configured using the **Bundles** discount category. -BOGO campaigns are commonly used for: +This guide focuses only on configuration steps. +To understand bundle multiplication, discount limits, and bundle behavior, see the [Product bundles](/build/product-bundles) overview. -- buy one, get one free -- buy 2, get 1 free -- buy from one collection, get a gift -- free items with value limits - -## Key concepts - -- **Buy X**: Products the customer must purchase. -- **Get Y**: Products the customer receives for free. -- **Minimum quantity**: How many items are required to trigger the reward. -- **Item discount limit**: Controls how many reward units are added per bundle. - -## BOGO scenarios - -Follow these step-by-step examples to configure popular BOGO offers. - -### Scenario 1: Basic BOGO (Buy one, get one free) +## Scenario 1: Buy one, get one free If a customer buys one **Small Cappuccino**, they get a second one for free. @@ -35,7 +20,7 @@ If a customer buys one **Small Cappuccino**, they get a second one for free. Start a **Discount Coupon** campaign. - + In the **Discount value** step, choose: **Bundles > Buy X, get Y for free** @@ -43,7 +28,7 @@ If a customer buys one **Small Cappuccino**, they get a second one for free. Select **Small Cappuccino** and set the minimum quantity to **1**. - + In **Discount effect**, choose: **Free products: Always add new units items** @@ -51,14 +36,14 @@ If a customer buys one **Small Cappuccino**, they get a second one for free. Select **Small Cappuccino** again and set the unit quantity to **1**. - + Save the campaign. - When the code is applied, Voucherify adds the second cappuccino at **$0**. + When the code is applied, Voucherify adds the second cappuccino at **\$0**. -### Scenario 2: Buy 2, get 1 free +## Scenario 2: Buy 2, get 1 free If a customer buys 2 items, they receive 1 extra unit for free. @@ -67,7 +52,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. Start a **Discount Coupon** campaign. - + In the **Discount value** step, choose: **Bundles > Buy X, get Y for free** @@ -75,7 +60,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. Select the required product and set the minimum quantity to **2**. - + In **Discount effect**, choose: **Free products: Always add new units items** @@ -90,7 +75,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. -### Scenario 3: Buy from one collection, get a free gift +## Scenario 3: Buy from one collection, get a free gift If a customer buys at least one item from a collection, they receive a free gift product. @@ -104,7 +89,7 @@ Example: Start a **Discount Coupon** campaign. - + In the **Discount value** step, choose: **Bundles > Buy X, get Y for free** @@ -112,7 +97,7 @@ Example: Select the required collection and set the minimum quantity to **1**. - + In **Discount effect**, choose: **Free products: Always add new units items** @@ -123,21 +108,25 @@ Example: Save the campaign. - Voucherify adds the free gift when the customer buys from the required collection. + Voucherify adds the free gift when the required condition is met. -### Scenario 4: BOGO with a value limit (Free items up to $100) +## Scenario 4: BOGO with a value limit (Free items up to \$100) Customers can receive free products, but the total discount is capped. Example: - Buy at least one item from Collection A -- Get items from Collection B for free, up to **$100** +- Get items from Collection B for free, up to **\$100** - + + Start a **Discount Coupon** campaign. + + + In the **Discount value** step, choose: **Bundles > Discount percentage off bundle items** @@ -145,16 +134,16 @@ Example: Select the required collection and set the minimum quantity to **1**. - + Choose: - **Product discount > Percent discount: Apply discount to item subtotal** + **Percent discount: Apply the discount to item subtotal** Set the discount to **100%**. - - Set the **Maximum discount amount** to **$100**. + + Set the **Maximum discount amount** to **\$100**. Select the collection that should be discounted. @@ -162,10 +151,10 @@ Example: Save the campaign. - Voucherify applies free items until the discount reaches the limit. + Voucherify applies free items until the total discount reaches the limit. -Keep BOGO offers simple by clearly defining what the customer must buy (Buy X) and what they receive for free (Get Y). +Keep BOGO offers simple. Clearly define what the customer must buy and what they receive for free. \ No newline at end of file From 7789576c97de90b1a1539aeff86e3a119d47eea7 Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Thu, 12 Feb 2026 15:17:49 +0100 Subject: [PATCH 3/5] BOGO --- documentation/{prepare => build}/bogo-scenarios.mdx | 0 documentation/docs.json | 6 +++--- 2 files changed, 3 insertions(+), 3 deletions(-) rename documentation/{prepare => build}/bogo-scenarios.mdx (100%) diff --git a/documentation/prepare/bogo-scenarios.mdx b/documentation/build/bogo-scenarios.mdx similarity index 100% rename from documentation/prepare/bogo-scenarios.mdx rename to documentation/build/bogo-scenarios.mdx diff --git a/documentation/docs.json b/documentation/docs.json index de1edf914..539c677ab 100644 --- a/documentation/docs.json +++ b/documentation/docs.json @@ -184,8 +184,7 @@ "group": "Products", "pages": [ "prepare/products", - "prepare/product-collections", - "prepare/bogo-scenarios" + "prepare/product-collections" ] }, "prepare/orders", @@ -208,7 +207,8 @@ "build/create-discount-promotions", "build/discount-types-and-effects", "build/discount-code-import", - "build/product-bundles" + "build/product-bundles", + "build/bogo-scenarios" ] }, { From cd02d8fcb152301098730db4dce75a4b1ea21ca5 Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Fri, 27 Mar 2026 15:02:22 +0100 Subject: [PATCH 4/5] Update bogo-scenarios.mdx --- documentation/build/bogo-scenarios.mdx | 70 +++++++++++++++++++------- 1 file changed, 53 insertions(+), 17 deletions(-) diff --git a/documentation/build/bogo-scenarios.mdx b/documentation/build/bogo-scenarios.mdx index b277aae98..17f369948 100644 --- a/documentation/build/bogo-scenarios.mdx +++ b/documentation/build/bogo-scenarios.mdx @@ -8,12 +8,16 @@ BOGO (Buy One Get One) campaigns reward customers when they buy selected product In Voucherify, BOGO offers are configured using the **Bundles** discount category. + +This guide uses products and collections available in a fresh Voucherify Sandbox environment. The examples below use Sandbox data visible by default, including the **All Products** collection and sample products such as **Johan & Nyström - Espresso | 250g**, **Johan & Nyström - Bourbon | 500g**, **Illy - Arabica | 250g**, **Shipping**, and **Watchflix | Plus**. + + This guide focuses only on configuration steps. To understand bundle multiplication, discount limits, and bundle behavior, see the [Product bundles](/build/product-bundles) overview. ## Scenario 1: Buy one, get one free -If a customer buys one **Small Cappuccino**, they get a second one for free. +If a customer buys one **Johan & Nyström - Espresso | 250g**, they get a second unit for free. @@ -25,7 +29,7 @@ If a customer buys one **Small Cappuccino**, they get a second one for free. **Bundles > Buy X, get Y for free** - Select **Small Cappuccino** and set the minimum quantity to **1**. + Select **Johan & Nyström - Espresso | 250g** and set the minimum quantity to **1**. @@ -33,13 +37,13 @@ If a customer buys one **Small Cappuccino**, they get a second one for free. **Free products: Always add new units items** - Select **Small Cappuccino** again and set the unit quantity to **1**. + Select **Johan & Nyström - Espresso | 250g** again and set the unit quantity to **1**. Save the campaign. - When the code is applied, Voucherify adds the second cappuccino at **\$0**. + When the code is applied, Voucherify adds the second product at **$0**. @@ -57,7 +61,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. **Bundles > Buy X, get Y for free** - Select the required product and set the minimum quantity to **2**. + Select **Illy - Arabica | 250g** and set the minimum quantity to **2**. @@ -65,7 +69,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. **Free products: Always add new units items** - Select the same product and set the unit quantity to **1**. + Select **Illy - Arabica | 250g** and set the unit quantity to **1**. @@ -81,8 +85,8 @@ If a customer buys at least one item from a collection, they receive a free gift Example: -- Buy any product from **Audiophile Zone** -- Get a free product from **Gift Collection** +- Buy any product from **All Products** +- Get **Shipping** for free @@ -94,7 +98,7 @@ Example: **Bundles > Buy X, get Y for free** - Select the required collection and set the minimum quantity to **1**. + Select **All Products** and set the minimum quantity to **1**. @@ -102,7 +106,7 @@ Example: **Free products: Always add new units items** - Select the gift product or collection and set the unit quantity to **1**. + Select **Shipping** and set the unit quantity to **1**. @@ -112,14 +116,14 @@ Example: -## Scenario 4: BOGO with a value limit (Free items up to \$100) +## Scenario 4: BOGO with a value limit (Free items up to $100) Customers can receive free products, but the total discount is capped. Example: -- Buy at least one item from Collection A -- Get items from Collection B for free, up to **\$100** +- Buy at least one item from **All Products** +- Get **Watchflix | Plus** for free, up to **$100** @@ -131,7 +135,7 @@ Example: **Bundles > Discount percentage off bundle items** - Select the required collection and set the minimum quantity to **1**. + Select **All Products** and set the minimum quantity to **1**. @@ -143,9 +147,9 @@ Example: - Set the **Maximum discount amount** to **\$100**. + Set the **Maximum discount amount** to **$100**. - Select the collection that should be discounted. + Select **Watchflix | Plus** as the discounted product. @@ -157,4 +161,36 @@ Example: Keep BOGO offers simple. Clearly define what the customer must buy and what they receive for free. - \ No newline at end of file + + +## Related features + + + + + +Use validation rules to control who can redeem the campaign and in what circumstances. For example, you can limit a BOGO campaign to selected customer segments, sales channels, order value, or cart conditions. + +Validation rules complement bundle configuration — bundles define **what must be in the cart**, while validation rules define **when the campaign is allowed**. + +See [Validation rules](/optimize/create-validation-rules). + + + + + +Learn how Voucherify handles bundle multiplication, item matching, and discount application. This is especially useful when customers qualify for the same BOGO offer multiple times in one cart. + +See [Product bundles](/build/product-bundles). + + + + + +Target BOGO campaigns to specific audiences, such as new customers or loyalty members, by combining bundle logic with segmentation. + +See [Customer segments](/prepare/customer-segments). + + + + \ No newline at end of file From 8621b66e1471f55d548121606e50daa6366dce46 Mon Sep 17 00:00:00 2001 From: MaciekVoucherify <130568368+MaciekVoucherify@users.noreply.github.com> Date: Wed, 22 Apr 2026 17:19:20 +0200 Subject: [PATCH 5/5] Update --- documentation/build/bogo-scenarios.mdx | 56 +++++++++++++------------- 1 file changed, 27 insertions(+), 29 deletions(-) diff --git a/documentation/build/bogo-scenarios.mdx b/documentation/build/bogo-scenarios.mdx index 17f369948..b7da6a04d 100644 --- a/documentation/build/bogo-scenarios.mdx +++ b/documentation/build/bogo-scenarios.mdx @@ -4,12 +4,14 @@ description: "Step-by-step guide to setting up Buy One Get One (BOGO) campaigns keywords: ['BOGO', 'buy one get one', 'bundles tutorial', 'cart promotions'] --- -BOGO (Buy One Get One) campaigns reward customers when they buy selected products. +BOGO (Buy One Get One) campaigns reward customers when they buy specific products or product groups. In Voucherify, BOGO offers are configured using the **Bundles** discount category. -This guide uses products and collections available in a fresh Voucherify Sandbox environment. The examples below use Sandbox data visible by default, including the **All Products** collection and sample products such as **Johan & Nyström - Espresso | 250g**, **Johan & Nyström - Bourbon | 500g**, **Illy - Arabica | 250g**, **Shipping**, and **Watchflix | Plus**. +This guide uses products and collections available in a fresh Voucherify Sandbox environment. + +Examples are based on default demo shop data, including collections such as **All Products** and **All coffees**, and products such as **Kenya – Espresso (250g)**, **Arabica (250g)**, and **Roast Master – coffee machine**. This guide focuses only on configuration steps. @@ -17,7 +19,9 @@ To understand bundle multiplication, discount limits, and bundle behavior, see t ## Scenario 1: Buy one, get one free -If a customer buys one **Johan & Nyström - Espresso | 250g**, they get a second unit for free. +This scenario shows the simplest BOGO setup where a customer receives the same product for free. + +If a customer buys one **Kenya – Espresso (250g)**, they get a second unit for free. @@ -29,7 +33,7 @@ If a customer buys one **Johan & Nyström - Espresso | 250g**, they get a second **Bundles > Buy X, get Y for free** - Select **Johan & Nyström - Espresso | 250g** and set the minimum quantity to **1**. + Select **Kenya – Espresso (250g)** and set the minimum quantity to **1**. @@ -37,7 +41,7 @@ If a customer buys one **Johan & Nyström - Espresso | 250g**, they get a second **Free products: Always add new units items** - Select **Johan & Nyström - Espresso | 250g** again and set the unit quantity to **1**. + Select **Kenya – Espresso (250g)** again and set the unit quantity to **1**. @@ -49,6 +53,8 @@ If a customer buys one **Johan & Nyström - Espresso | 250g**, they get a second ## Scenario 2: Buy 2, get 1 free +This scenario extends the basic BOGO setup by increasing the required quantity. + If a customer buys 2 items, they receive 1 extra unit for free. @@ -61,7 +67,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. **Bundles > Buy X, get Y for free** - Select **Illy - Arabica | 250g** and set the minimum quantity to **2**. + Select **Arabica (250g)** and set the minimum quantity to **2**. @@ -69,7 +75,7 @@ If a customer buys 2 items, they receive 1 extra unit for free. **Free products: Always add new units items** - Select **Illy - Arabica | 250g** and set the unit quantity to **1**. + Select **Arabica (250g)** and set the unit quantity to **1**. @@ -81,12 +87,12 @@ If a customer buys 2 items, they receive 1 extra unit for free. ## Scenario 3: Buy from one collection, get a free gift -If a customer buys at least one item from a collection, they receive a free gift product. +This scenario shows how to separate required products from the reward by using collections. Example: -- Buy any product from **All Products** -- Get **Shipping** for free +- Buy any product from **All coffees** +- Get **Kenya – Espresso (250g)** for free @@ -98,7 +104,7 @@ Example: **Bundles > Buy X, get Y for free** - Select **All Products** and set the minimum quantity to **1**. + Select **All coffees** and set the minimum quantity to **1**. @@ -106,24 +112,24 @@ Example: **Free products: Always add new units items** - Select **Shipping** and set the unit quantity to **1**. + Select **Kenya – Espresso (250g)** and set the unit quantity to **1**. Save the campaign. - Voucherify adds the free gift when the required condition is met. + Voucherify adds the free product when the required condition is met. ## Scenario 4: BOGO with a value limit (Free items up to $100) -Customers can receive free products, but the total discount is capped. +This scenario shows how to replace free items with a capped discount. Example: -- Buy at least one item from **All Products** -- Get **Watchflix | Plus** for free, up to **$100** +- Buy at least one item from **All coffees** +- Get **Roast Master – coffee machine** discounted up to **$100** @@ -135,7 +141,7 @@ Example: **Bundles > Discount percentage off bundle items** - Select **All Products** and set the minimum quantity to **1**. + Select **All coffees** and set the minimum quantity to **1**. @@ -149,18 +155,18 @@ Example: Set the **Maximum discount amount** to **$100**. - Select **Watchflix | Plus** as the discounted product. + Select **Roast Master – coffee machine** as the discounted product. Save the campaign. - Voucherify applies free items until the total discount reaches the limit. + Voucherify applies the discount up to the defined maximum amount. -Keep BOGO offers simple. Clearly define what the customer must buy and what they receive for free. +Keep BOGO offers simple. Clearly define what the customer must buy and what they receive. ## Related features @@ -171,20 +177,12 @@ Keep BOGO offers simple. Clearly define what the customer must buy and what they Use validation rules to control who can redeem the campaign and in what circumstances. For example, you can limit a BOGO campaign to selected customer segments, sales channels, order value, or cart conditions. -Validation rules complement bundle configuration — bundles define **what must be in the cart**, while validation rules define **when the campaign is allowed**. +Validation rules complement bundle configuration, bundles define **what must be in the cart**, while validation rules define **when the campaign is allowed**. See [Validation rules](/optimize/create-validation-rules). - - -Learn how Voucherify handles bundle multiplication, item matching, and discount application. This is especially useful when customers qualify for the same BOGO offer multiple times in one cart. - -See [Product bundles](/build/product-bundles). - - - Target BOGO campaigns to specific audiences, such as new customers or loyalty members, by combining bundle logic with segmentation.