> ## 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 Free Gift Campaign

# Setting up a Free Gift Campaign

Choose your free gift type to jump directly to the setup steps:

| What you want to do | Go to |
| ---- |
| Give one specific gift automatically when a threshold is met | [Type 1: Auto-Add](#3-type-1-auto-add) |
| Let customers choose their gift from a selection | [Type 2: Customer Selection](#3-type-2-customer-selection) |
| Give multiple gifts at the same threshold | [Type 3: Multiple Gifts at the same threshold](#3-type-3-multiple-gifts-at-the-same-threshold) |
| Give different gifts at different spend levels | [Type 4: Tiered Gifts](#3-type-4-tiered-gifts) |

## Common Settings
These apply to every free gift type. Configure them during setup.

**Threshold:** Choose what unlocks the gift — a minimum spend amount (e.g., $100) or a quantity of items (e.g., Buy 5). You can calculate the threshold across all products, specific products, or specific collections.

**Discount Combinations:** If you're running other Shopify discounts alongside this free gift, ensure "Combines with Product Discounts" is enabled on both the Kite offer and the Shopify discount.
**Scheduling:** Set a start and end date, or let it run continuously.

## Eligibility and Targeting
Below the main gift rules, you'll see three separate sections to control who qualifies for your offer and under what conditions.

**Cart Eligibility:** Add extra conditions the cart must meet *on top of* the base threshold. Click **Add rule** to add conditions like:
* **Cart quantity** — minimum number of items in cart
* **Cart subtotal** — minimum cart value
* **Specific products** — cart must include certain products
* **Products with variants** — cart must include specific variants
* **Collections** — cart must include products from specific collections
Example: Your threshold is "Spend $100 to get a free gift," but you also add a cart eligibility rule requiring a product from the "Summer Collection." The customer must spend $100 *and* have a Summer Collection item in the cart to unlock the gift.

**Customer Eligibility:** Click **Add rule** to restrict who can see and claim the offer:
* **Customer tags** — only customers with specific Shopify tags (e.g., "VIP") see the offer
* **Customer logged in** — only logged-in customers see the offer

**Markets:** Click **Edit** to restrict the offer to specific Shopify Markets. Applies to all markets by default.
⚠️ If you have individual countries set up as separate markets (e.g., "Australia" under a parent "International" market), you must select them by name — selecting only the parent market won't include them.

## Free Gift Types
To start: **Create Promotion → Free Gift on Product Page/Cart** → name your offer.

### Type 1: Auto Add
*Gift is added to cart automatically when conditions are met.*
${youtube}[Setting up a Free gift to be auto added at a specific threshold](o_C2vMbNiEU)
1. Set your preferred threshold (e.g., Spend $100 across All Products).
2. Select the specific product you want to offer as the free gift.
3. Ensure the behavior is set to auto-add. Once the customer hits the threshold, the gift automatically drops into their cart.

### Type 2: Customer Selection
*Customer picks their gift from options you define.*
${youtube}[Setting up a 'Choose Your Gift' offer at a specific threshold](pgqoj2zfCxI)
1. Set your threshold.
2. Select a product with variants, OR select multiple different products.
3. Change the behavior to **Let customer select free gift**.
4. Set your **Selection Limit** (e.g., choose 1 out of the 3 options). The widget will allow the customer to pick their preferred item/variant and block the rest once the limit is reached.

### Type 3: Multiple Gifts at the same Threshold
*Customer receives several gifts at the same threshold — automatically.*
${youtube}[Setting up multiple Free gifts to be auto added at a specific threshold](SYkZIdL40QE)
1. Set your threshold.
2. Select your free gift product(s).
3. To give multiples of the *same* item, increase the quantity selector (e.g., set to 3). To give *different* items, simply add multiple products to the offer.
4. Ensure the behavior is set to **Automatically add free gift**. Customers will receive all configured items when they cross the single threshold.
**Free Gift Multiplier:** Want the gift to repeat as the customer buys more (e.g., 1 free pin for every 2 shirts)? In **Advanced Settings**, toggle on **"Set a maximum number of uses per order"** and enter a cap. The gift will be issued each time the customer meets the condition, up to your limit.

### Type 4: Tiered Gifts
*Different gifts unlock at different spend levels — "Spend more, get better gifts."*
${youtube}[Setting up multiple Free gifts at multiple different thresholds](6zseNmKOIgQ)
1. Set your Tier 1 threshold (e.g., Spend $100) and select the Tier 1 free gift.
2. Enable the **Multiple Tiers** toggle and click **Add Rule** to create Tier 2 (e.g., Spend $200) and assign its respective gift. Repeat for Tier 3.
3. **Application Rule:** Choose whether the customer gets *only* the highest tier gift they qualify for, or if they accumulate all gifts as they move through the tiers.
**Highest tier only:** To guarantee only the single highest-tier gift is added, enable **"Add the free gift from the highest tier"** in Advanced Settings.


## Publishing and Theme Setup
**1. Enable the Theme App Extension** Go to Online Store → Themes → Customize → App Embeds → toggle **Kite** ON → Save. Without this, no widgets appear on your store.
**2. Test with a Private Link** When you first save an offer, Kite generates a Private Preview Link. Use it to test before going public.
**3. Go Public** In the Offer Summary, switch from **Private** to **Public**.

## Technical Notes
| Issue | Detail |
| ---- |
| **"Buy Now" buttons** | Dynamic checkout (Buy Now, Apple Pay, Shop Pay) bypasses the cart. Free gifts won't be added. Customers must use standard "Add to Cart." |
| **$0 gift products** | If the gift is priced at $0, customers can add it without qualifying. Give it a real price — Kite's discount brings it to zero. Or [hide the Add to Cart button →](https://help.skailama.com/en/article/how-to-hide-add-to-cart-quantity-selectors-for-free-gift-products-3c760be9/) |
| **Side cart not refreshing** | Some themes don't auto-refresh when a gift is added. Configure a CSS selector in Settings → Widget Settings → Cart Refresh. [Fix guide →](https://help.skailama.com/en/article/how-to-fix-side-cart-refresh-issue-for-free-gift-addition-39eb2cd7/) |
| **Discount stacking** | A free gift is a product discount (100% off). If another product discount is active and combinations aren't enabled, the gift will be blocked. |

## Troubleshooting
**Widget not showing?** → Check that the Kite App Embed is ON in your theme editor (App Embeds section). Check that at least one location is selected under "Show offer widget" in the promotion. Check the scheduled start date.
**Gift not adding to cart?** → If the offer is Private, use the Private Preview Link. If you used "Buy Now," switch to "Add to Cart." Check Discount Combination settings if another automatic discount is running.
**"Claim" button greyed out?** → The gift product must be **Active** and **published to Online Store** in Shopify Admin. It also needs inventory — Kite can't add a product with zero stock.
**Product image missing on widget?** → This happens when images are changed after the product was selected. Open the promotion → remove the gift product → re-add it → Save.
**Gift not removing when cart drops below threshold?** → Ensure you're on the latest version of Kite. If it persists, contact support via in-app chat.
**Want to customize the widget?** → Click "Edit and Style Widget" on the offer setup page. Use **variables** like `{{free_gift_product_title}}` and `{{remaining_amount}}` for dynamic text. [Variables guide →](https://help.skailama.com/en/article/how-to-use-variables-for-dynamic-free-gift-widgets-in-kite-bad1b813/)