> ## 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 Buy X Get Y offer

The **Buy X Get Y** offer allows you to reward customers with discounted or free items (Y) when they purchase specific trigger products (X). You can configure this via the Kite "Create Promotion" menu and customize the offer widget to match your store’s branding.

1. **Select Offer Type:** In the Kite dashboard, click **Create Promotion** and select **Buy X Get Y**, then choose the **Quick Buy X Get Y** template.
2. **Define the Trigger (Buy X):** Choose specific products, collections, or tags that "trigger" the offer. Set the minimum quantity required (e.g., "Buy 1").
3. **Define the Reward (Get Y):** Select the products the customer is eligible to receive. You can set a **Quantity Limit** (e.g., Buy 1 X, get up to 2 Ys at a discount).
4. **Set the Discount:** Choose between a **Percentage Off**, **Fixed Amount Off**, or a **Fixed Selling Price** for the "Y" items.
5. **Usage Limits & Targeting:** Set the "Maximum uses per order" to prevent over-claiming. You can also restrict the offer to specific **Shopify Markets**, **Customer Tags** (e.g., VIPs), or **Logged-in users**.
6. **Design the Widget:** Use the Kite Page Editor to style the widget’s colors, layout, and text. You can also choose which specific pages or products the widget should appear on.

${youtube}[Setting up Buy X get Y](kFb8uXtwqqw)

**Technical Notes & Limitations:**
* **Checkout Isolation:** This offer will **not work** if a customer clicks a "Buy Now" or "Apple Pay" button directly from the product page. These buttons skip the cart, preventing Kite from adding the "Y" product.
* **Stacking Logic:** Ensure your "Discount Combination" settings in Kite match your intent. If you want customers to use a coupon code *on top* of this offer, both must be set to "Combine" in your Shopify/Kite settings.
* **Inventory:** If the "Y" product is out of stock, the discount cannot be applied, and the widget may not function as expected.

**Troubleshooting Checklist:**
* [ ] **Is the promotion Active?** Check that the status is not set to "Draft."
* [ ] **Did you test with a standard "Add to Cart"?** Avoid "Buy It Now" buttons during testing.
* [ ] **Check Customer Eligibility:** If you set a "Tag" requirement, ensure you are logged into a test account with that specific tag.