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

Install CartSprinkle on Shopify App Store

  1. 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.

  2. Once installed, open Online Store → Customize Theme.

  3. 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

Create first promotion

  1. In the CartSprinkle dashboard, open Promotions → Create Promotion.

  2. 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.
  3. Under Gift Configuration, select:

    • Single Gift (auto-adds silently) or Multiple Variant Selection (shows a popup).
  4. Set promotion options:

    • Priority and Allow Stacking.
  5. Click Save & Activate.

Your promotion is now live and will appear automatically when conditions are met.

🎨 Step 3 -- Customize the Popup or Chicklet

Customize the popup

CartSprinkle provides two shopper-facing experiences:

Popup Modal

Chicklet Reminder

Customize both under Promotions → Display Settings.
No code needed -- just update fields and click Save.

🧪 Step 4 -- Test Your Promotion

Before announcing it publicly:

  1. Add qualifying items to your cart.
  2. Watch CartSprinkle automatically add the gift line item via /cart/add.js.
  3. Confirm the gift shows $0 instantly (BXGY discount applied).
  4. Remove the trigger product or drop below the threshold -- verify the gift disappears.
  5. Check Dashboard → Recent Orders to see attributed orders.

📊 Step 5 -- Monitor Performance

Monitor promotion performance

Open the Dashboard for live stats:

If a promotion pauses unexpectedly, check Pause Reason Tracking -- usually triggered by the Auto-Pause system when stock runs low.

🧱 Best Practices

📋 Key Takeaways