> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # ๐Ÿš€ How to setup Buy One Get One (BOGO) Want to run a classic โ€œBuy 1 Get 1 Freeโ€ deal โ€” or any Buy X Get Y variation โ€” without touching discount codes? ๐ŸŽ Thatโ€™s exactly what the **BOGO (Buy One Get One)** offer in Hoppy Bundles is designed for. With this offer type, you can create deals such as: * ๐Ÿ›’ Buy 1 โ†’ Standard Price * ๐ŸŽ‰ Buy 2 โ†’ Get 1 Free * ๐Ÿ”ฅ Buy 3 โ†’ Get 1 Free โ€”and display them as a neat, clickable widget directly on your product page. Customers simply pick the deal they like, and the free item discount is applied automatically at checkout โœจ โ„น๏ธ BOGO uses the same setup screen as a **Quantity Break** offer โ€” it just opens pre-filled with BOGO-style tiers and the **YAY \! Itโ€™s BOGO** template, so youโ€™re never starting from a blank page. --- # **๐Ÿ“ Where the BOGO Widget Appears** The BOGO widget appears on your **Product Page**, right below the Add to Cart button (default placement). You can also place it anywhere else on the product page using the **Custom placement** option (covered later in this guide). โ„น๏ธ The free item is added and discounted **automatically at checkout** โ€” customers donโ€™t need to add the free item to the cart themselves or enter any discount code. --- # **๐Ÿ› ๏ธ Example Setup Used in This Documentation** In this documentation, weโ€™ll configure the following BOGO structure (this is exactly what Hoppy Bundles pre-fills for you): * ๐Ÿ›’ 1 Pair โ†’ Standard Price (No Discount) * ๐ŸŽ‰ Buy 2 Get 1 โ†’ the 3rd item is free * ๐Ÿ”ฅ Buy 3 Get 1 โ†’ the 4th item is free The offer will be applied to **specific products** and displayed using the pre-selected **YAY \! Itโ€™s BOGO** template. This guide explains each setting youโ€™ll touch during setup, so you know exactly how every option behaves โš™๏ธ --- # **โœ… Before You Begin โ€” Enable the App Embed** For the BOGO widget to appear on your storefront, the app embed must be enabled inside your Shopify theme. Go to: **Shopify Admin โ†’ Sales Channels โ†’ Online Store โ†’ Themes โ†’ Customize โ†’ App Embeds** Then: * Find **Bundles App Embed** * Toggle it ON * Click Save โš ๏ธ **Important**: Without the app embed enabled, your published offer will not be visible on the storefront โ€” even if everything inside the app is configured correctly. --- # **๐ŸŽฏ Step 1 โ€” Create a New BOGO Offer** Open the **Hoppy Bundles** app from your Shopify Admin. Then: โ†’ Click **Create New Offer** to open the offer type selection page. โ†’ Find the **BOGO (Buy One Get One)** card โ€” *โ€œBuy one product and get another free or discountedโ€* โ€” and click **Create a BOGO Offer**. ๐Ÿ’ก Want the customer to buy a fixed quantity and get a **different product** at a discount instead? The **Buy X Get Y** card right next to it opens the same setup with tiers pre-filled for that flow (e.g. โ€œBuy 2 Get 3โ€). --- # **๐Ÿงฉ Step 2 โ€” Name Your Offer & Choose Where It Applies** The first screen asks for the basics before anything else. --- ## **๐Ÿท๏ธ Offer Name** This field is used for internal purposes only. Customers will never see this name. You can use any recognizable name such as: * Summer BOGO Sale * T-Shirt Buy 2 Get 1 * Black Friday BOGO ๐Ÿ’ก Using proper internal naming makes it easier to identify setups later, especially if your store runs multiple offers. --- ## **๐Ÿ“ฆ Apply Offer On** This setting controls which products the BOGO deal applies to. There are 3 available options: * **All Products** โ†’ the offer applies to every product in your store * **Product** โ†’ the offer applies only to the products you select * **Collection** โ†’ the offer applies to every product inside the collections you select If you choose **Product** or **Collection**, a **Select Product** / **Select Collection** button appears. Click it to open your Shopify resource picker and choose one or more items. โš ๏ธ **Important**: Only **one published offer** is allowed per product or collection. If another published offer already covers the same product, youโ€™ll need to convert that one to a draft before publishing this one. --- # **๐ŸŽจ Step 3 โ€” Pick a Template** Next, youโ€™ll see the **Select Your Preferred Offer** section with a row of ready-made widget templates. Because you started from the BOGO card, the **YAY \! Itโ€™s BOGO** template (the violet one ๐Ÿ’œ) is already pre-selected for you โ€” you can simply keep it. You can also pick a different starting point: * **Bundle & Save** โ†’ build one from scratch * **Limited Time Offer** โ†’ orange-themed tiers * **Flash Sale Madness\!** โ†’ pink-themed tiers * **YAY \! Itโ€™s BOGO** โ†’ violet-themed BOGO tiers (pre-selected) Once youโ€™re happy with the selection, click **Apply selected template**. โš ๏ธ The apply button stays disabled until youโ€™ve selected at least one product or collection (when **Apply Offer On** is set to **Product** or **Collection**). After applying, the full editor opens with a **live preview** on the right โ€” both **desktop** and **mobile** โ€” that updates instantly as you change settings โœจ --- # **โš™๏ธ Step 4 โ€” Configure Your BOGO Tiers (General Tab)** This is where your BOGO deal actually takes shape. Youโ€™ll see your tiers as tabs โ€” **Offer 1**, **Offer 2**, **Offer 3** โ€” each one a clickable deal on the storefront widget. --- ## **โœ๏ธ Offer Name & Selected Offer** At the top of the General tab, a small summary card shows your **Offer Name** (click the โœ๏ธ icon to rename it) and your **Selected Offer** template. --- ## **๐Ÿ“ Template Layout** Choose how the tiers are displayed: * **Vertical** โ†’ tiers stacked on top of each other (default) * **Horizontal** โ†’ tiers side by side With the **Vertical** layout, you also get a **Choose a theme** option with quick color presets (blue, red, green). --- ## **๐ŸŽ Edit Offer โ€” Your BOGO Tiers** Each tier tab has its own settings. Hereโ€™s what each one does for a BOGO setup: ### **๐Ÿ’ธ Discount Type** This dropdown is the heart of your tier. The BOGO-relevant options are: * **No Discount** โ†’ the items are sold at standard price (perfect for your โ€œ1 Pairโ€ base tier) * **BOGO (Buy One Get One)** โ†’ buy the tier quantity, get extra item(s) of the **same product** free * **Buy X Get Y Free** โ†’ buy the tier quantity, get a **different product** (the โ€œYโ€ product) free The other discount types (**% Discount**, **Flat discount**, **On each unit flat discount**, **Specific Price**) also work here if you ever want a mixed widget โ€” e.g. one BOGO tier plus one โ€œ20% OFFโ€ tier. ### **๐Ÿ”ข Quantity \+ Buy / Get** The **Quantity** field controls how many items the customer adds when they pick this tier โ€” and for BOGO tiers, it also sets the **Buy** amount automatically. * With **BOGO (Buy One Get One)** selected, youโ€™ll see **Buy** and **Get** boxes instead of a discount value. Both are read-only: **Buy** always matches the tier quantity, and **Get** is fixed at **1 free item**. * With **Buy X Get Y Free** selected, **Buy** follows the tier quantity, but **Get** is **editable** โ€” so you can offer โ€œBuy 2, Get 3โ€ style deals. ๐Ÿ’ก Want a classic **Buy 1 Get 1 Free**? Just set a tierโ€™s **Discount Type** to **BOGO (Buy One Get One)** and its **Quantity** to **1** โ€” done. ### **๐ŸŽ Get Product (Buy X Get Y Free only)** When a tier uses **Buy X Get Y Free**, an extra **Get Product** section appears. Click **Select Y Product** to open the resource picker and choose the free product your customer receives. โ„น๏ธ This is how you do โ€œBuy a hoodie, get a cap freeโ€. With the plain **BOGO (Buy One Get One)** type, the free item is always more of the **same product**, so no Y product is needed. ### **๐Ÿท๏ธ Offer Title, Discount Label & Tag** * **Offer Title** โ†’ the main text of the tier, e.g. *Buy 2 Get 1* * **Discount Label** โ†’ the savings text shown on the tier, e.g. *Buy 2 get 1* โ€” click the ๐Ÿ‘๏ธ icon to hide it * **Tag** โ†’ a small highlight badge, e.g. *Most Popular* โ€” also hideable with the ๐Ÿ‘๏ธ icon ๐Ÿ’ก The pre-filled tiers already say โ€œBuy 2 Get 1โ€ and โ€œBuy 3 Get 1โ€ โ€” just tweak the wording to match your brandโ€™s voice. ### **๐ŸŽ Free Gift (optional)** Tick the **Free gift** checkbox on any tier, then click **Select Products** to attach extra free gift products to that tier โ€” on top of the BOGO free item itself. ### **โž• Add / ๐Ÿ—‘๏ธ Delete Tiers** * Click **Add Offer** to add another tier (maximum **6** tiers) * Click **Delete** to remove the current tier (at least **2** tiers are required) --- ## **๐Ÿ“ฐ Block Title & Footer Text** * **Block Title** โ†’ the heading above the widget. Itโ€™s pre-filled with **โ€œBOGO Offerโ€** โ€” change it to anything you like, or hide it with the ๐Ÿ‘๏ธ icon * **Footer Text** โ†’ a small line below the tiers (default: *Free Shipping*), also hideable --- # **๐Ÿ› ๏ธ Step 5 โ€” Configure Settings** Still on the **General** tab, the **Settings** card controls how the widget behaves. ## **๐Ÿ‘€ Appearance and Looks** * **Show unit price** โ†’ display the per-item price inside each tier * **Show total price** โ†’ display the tierโ€™s total price * **Hide header and footer lines** โ†’ removes the widgetโ€™s header/footer divider lines * **Use custom text for Out of Stock** โ†’ shows your own message when the product is out of stock (a text field appears below when enabled) ## **โš™๏ธ Functionality** * **Let customers choose different variants for each item** โ†’ handy for BOGO โ€” e.g. buy 2 shirts, pick a different size/color for each, and still get the free one * **Display widget below add to cart button** โ†’ keeps the widget anchored under the Add to Cart button * **Skip cart directly to checkout** โ†’ sends customers straight to checkout when they pick a tier * **Volume Discount (Extend Max Discount to All Quantities)** โ†’ lets customers buy additional items beyond the highest tier at the same maximum discount rate * **Show compare to price** โ†’ shows the struck-through compare-at price; enabling it reveals **Custom compare price** and **Shopify product compare price** fields ## **๐Ÿ”„ Enable Discount Combination** * **Order discounts** โ†’ allow this offer to combine with order-level discounts * **Shipping discounts** โ†’ allow it to combine with shipping discounts โ„น๏ธ Product discounts always combine. Due to Shopify restrictions, this combination setting applies globally to all new quantity-break-based offers (including BOGO). ## **๐ŸŒ Multiple Markets & Translation** Further down youโ€™ll find **Multiple Markets** (different tiers per market) and **Translation** (widget text in your storeโ€™s other languages). Both are optional and covered in their own dedicated guides. --- # **๐ŸŽฏ Step 6 โ€” Targeting & Placement (Optional)** The **Targeting & Placement** tab controls where and to whom the offer shows. ## **๐Ÿ“ Placement** * **Below Add to Cart Button (Default)** โ†’ no extra work needed * **Custom (only on product page)** โ†’ after saving, youโ€™ll get your **Hoppy bundles ID** and a copyable **code snippet** to drop anywhere in your theme ## **๐Ÿ‘ค Customer Targeting & ๐ŸŒ Geolocation Targeting** * Show or hide the offer based on **login status, customer tags, or total amount spent** * Limit the offer to **specific countries** (default: **All world**) Thereโ€™s also a **Scheduling** section to set a **start** and **end** date/time for the offer โ€” perfect for a weekend BOGO flash sale โฐ โ„น๏ธ All of these are optional. If you skip them, the offer simply shows to everyone, everywhere, right away. Advanced targeting is covered in detail in its own dedicated guide. --- # **๐ŸŽจ Design Tab (Optional)** The **Design** tab controls the visual styling of the widget: * **Typography & Colour** โ†’ font family, text sizes, weights, and colors for every element * **Variant** โ†’ small / medium / large sizing for variant selectors * **Border** โ†’ border width and corner radius sliders ๐Ÿ’ก Every change reflects instantly in the live preview on the right โ€” both in the **desktop** and **mobile** preview panels. โ„น๏ธ The pre-selected **YAY \! Itโ€™s BOGO** template already looks great out of the box, so this step is entirely optional. Styling is covered in depth in the dedicated design guide. --- # **โœ… Final Step โ€” Save & Publish** Once everything looks good in the preview: 1. Click **Save** in the save bar at the top of the page 2. Click **Publish** to make the offer live โš ๏ธ **Please note**: * The **Publish** button is disabled while the offer is brand new โ€” **save first**, then publish. * Publishing creates an **automatic discount** in your **Shopify Admin โ†’ Discounts**. This is what actually applies the free items at checkout โ€” please donโ€™t delete or edit it manually. * If the app embed is not enabled in your theme, a banner will appear after saving with an **Enable App Embed** shortcut button โ€” click it, toggle the embed on, and save your theme. * If publishing fails because another published offer already covers the same product or collection, convert that existing offer to a draft first, then publish again. Your BOGO offer is now live ๐Ÿš€ --- # **๐ŸŽ‰ Final Result** Once configured successfully: โœ… Customers see your BOGO tiers directly on the product page โœ… Free items are added and discounted automatically at checkout โœ… Tiers, tags, and labels update instantly from the app โœ… The widget matches your theme with the template and colors you picked Hereโ€™s how the finished widget looks on the storefront โ€” clear BOGO deals, one-click selection, and free items applied automatically at checkout โœจ --- ๐Ÿ’ก Want the free item to be a **different product** instead of more of the same? Edit a tier, switch its **Discount Type** to **Buy X Get Y Free**, and pick your free product with **Select Y Product** โ€” no need to start over.