> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://kite.skailama.app/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).

# Setting up a BOGO

You can create a BOGO discount in the Kite app by selecting the BOGO promotion type, setting your "buy" and "get" rules, and choosing whether the reward is a free item or a discounted product. If configured as a completely free item, Kite can automatically add the reward directly to the customer's cart.

Follow these step-by-step instructions to configure your BOGO offer:

1. **Create the Offer:** Open the Kite discounts app, click **Create Promotion**, and select **BOGO**.
2. **Name and Select Products:** Give your discount a recognizable name and select the products you want to include in the promotion.
3. **Set Quantities:** Define your specific trigger ratios (e.g., Buy 1, Get 1 or Buy 2, Get 1).
4. **Same vs. Different Products:**
   * *Same Product Enabled:* The customer must buy multiples of the exact same item (e.g., Buy 2 Body Scrubbers, get 1 Body Scrubber free).
   * *Same Product Disabled:* The customer can mix and match from your selected list (e.g., Buy 1 Body Scrubber and 1 Face Mask, get 1 Bath Oil free).
5. **Select Discount Type:** Choose your reward (Free, Percentage Off, or Amount Off). *Note: If there are multiple variants for the free item, the customer will need to select their preferred variant to add it.*
6. **Set Limits:** Specify the maximum number of discounted products allowed in a single order. Setting this to `0` removes the limit, meaning the BOGO rule will apply infinitely every time the cart condition is met.
7. **Combinations & Advanced Settings:** Choose if the discount can be combined with other offers. You can also configure scheduling, make it a manual discount code, restrict it to a private URL, or add targeting rules (Customer Tags, Cart Totals, Subscriptions, POS).
8. **Customize Widgets:** After saving, you will be taken to the display section. Here you can enable and customize the design (colors, text, sizing) of the Product Page Widget, Side Cart BOGO Widget, and Collection Page Discount Pills.

**Technical Notes & Limitations:**
* **Auto-Add Requirements:** For Kite to automatically add the reward item to the cart, the discount type *must* be set to **Free** and apply to the same product (or a single-variant product). Auto-add is not supported for percentage or amount-off discounts, per Shopify's guidelines.
* **Accelerated Checkouts:** "Buy Now" and dynamic checkout buttons (like Apple Pay, Shop Pay, or Google Pay) completely bypass the cart step. Because Kite relies on the cart to trigger the auto-add feature, customers using "Buy Now" buttons will not receive their free item.
* **Discount Stacking:** Kite relies entirely on Shopify's native discount combination settings for stacking multiple offers.

**Troubleshooting Checklist:**
* **Widgets or discount pills not displaying?** Verify that the Kite **Theme App Extension** is toggled on in your Shopify Theme Editor. You do not need to manually place App Blocks for the core functionality, but the main extension must be enabled.
* **Free item not automatically adding?** Double-check that your discount type is set strictly to "Free" (not 100% off) and ensure the customer is using standard "Add to Cart" functionality rather than a "Buy Now" button.
* **Can't see the live offer on your storefront?** Newly saved offers are placed in Test Mode. Use the custom link provided in the Kite offer dashboard to view and test the offer privately before pushing it live to customers.