⚙️ Step 1 -- Install and Enable the Theme Extension

Search for CartSprinkle in the Shopify App Store or visit **CartSprinkle - Gift With Purchase** and install it.
Take advantage of the 7-day full-featured free trial.Once installed, open Online Store → Customize Theme.
In the left navigation, find App Blocks, then toggle on "CartSprinkle Auto-Add."
No code edits required -- CartSprinkle is a Theme App Extension compatible with all Online Store 2.0 themes.
🧩 Step 2 -- Create a Promotion

In the CartSprinkle dashboard, open Promotions → Create Promotion.
Choose your Trigger Type:
- Spend Threshold - e.g., "Spend $50 + to unlock a gift."
- Specific Product - e.g., "Buy Premium Shampoo → get a free Travel Size."
- Multiple Products - any of several items trigger the same gift.
Under Gift Configuration, select:
- Single Gift (auto-adds silently) or Multiple Variant Selection (shows a popup).
Set promotion options:
- Priority and Allow Stacking.
Click Save & Activate.
Your promotion is now live and will appear automatically when conditions are met.
🎨 Step 3 -- Customize the Popup or Chicklet

CartSprinkle provides two shopper-facing experiences:
Popup Modal
- Appears when a qualifying promotion triggers.
- Lets shoppers choose their gift if variants exist.
- Fully customizable: title, subtitle, colors, button text, border radius, overlay opacity.
Chicklet Reminder
- Small floating badge (🎁 "Free Gift!" by default).
- Reopens the popup if dismissed.
- Positionable in any corner, auto-hides after a delay, and matches your color palette.
Customize both under Promotions → Display Settings.
No code needed -- just update fields and click Save.
🧪 Step 4 -- Test Your Promotion
Before announcing it publicly:
- Add qualifying items to your cart.
- Watch CartSprinkle automatically add the gift line item via
/cart/add.js. - Confirm the gift shows $0 instantly (BXGY discount applied).
- Remove the trigger product or drop below the threshold -- verify the gift disappears.
- Check Dashboard → Recent Orders to see attributed orders.
📊 Step 5 -- Monitor Performance

Open the Dashboard for live stats:
- Total Orders containing gifts
- Total Revenue from those orders
If a promotion pauses unexpectedly, check Pause Reason Tracking -- usually triggered by the Auto-Pause system when stock runs low.
🧱 Best Practices
- Start with one simple Spend Threshold campaign (e.g., $50 +).
- Use Auto-Pause when inventory ≤ 5 units.
- Keep gift value under 10 % of AOV for margin safety.
- Test popup styling on mobile and desktop.
📋 Key Takeaways
- CartSprinkle uses Shopify's BXGY Automatic Discounts for reliable $0 gift pricing.
- Setup requires no code -- everything runs through the Theme App Extension.
- The Popup and Chicklet features ensure customers never miss their reward.
- Real-time inventory protection prevents overselling gifts.
- You can create and pause promotions in minutes.