Theme Extension Setup

What is the Theme Extension?

The CartSprinkle theme extension is a small piece of code that runs on your Shopify storefront. It automatically adds gift products to the cart when customers meet your promotion criteria.

How to Enable the Theme Extension

Step 1: Access Your Theme Customizer

1. Log in to your Shopify Admin
2. Go to Online Store → Themes
3. Find your active theme (marked with a green "Current theme" badge)
4. Click the Customize button

Step 2: Find App Embeds

1. In the theme customizer sidebar (left side), scroll to the very bottom
2. Click on App embeds
3. This section shows all app extensions available for your theme

Step 3: Enable CartSprinkle Gift Auto-Add

1. Look for CartSprinkle Gift Auto-Add in the list
2. Toggle the switch to ON (it should turn green/blue) ✅
3. Click Save in the top right corner

What Does the Extension Do?

Once enabled, the theme extension:

• ✅ Monitors the cart - Watches for changes to cart contents and totals
• ✅ Checks promotion rules - Compares cart against your active promotions
• ✅ Auto-adds gifts - Adds gift products when criteria are met
• ✅ Auto-removes gifts - Removes gifts if criteria are no longer met
• ✅ Displays messages - Shows promotional messages to customers

Troubleshooting

Can't Find "CartSprinkle Gift Auto-Add"?

Solution:

1. Close the theme customizer completely
2. Verify CartSprinkle is installed (Shopify Admin → Apps)
3. Open the theme customizer again
4. Hard refresh your browser (Ctrl+Shift+R or Cmd+Shift+R)
5. Check App embeds again

Extension Not Working?

Checklist:

• ✅ Extension toggle is ON (not OFF)
• ✅ You clicked Save after enabling
• ✅ You're testing on the correct theme (must be active theme)
• ✅ You have at least one active promotion
• ✅ Your cart meets the promotion criteria

Changes Not Showing?

Solution:

1. Clear your browser cache or test in incognito mode
2. Wait 1-2 minutes for changes to propagate
3. Hard refresh the storefront (Ctrl+Shift+R or Cmd+Shift+R)

Multiple Themes

If you have multiple themes (e.g., main theme + seasonal theme):

• You must enable the extension on each theme separately
• The extension only works on the active/published theme
• When you switch themes, verify the extension is enabled on the new active theme

Does It Affect Performance?

No. The theme extension is:

• ✅ Lightweight - Only a few KB of code
• ✅ Optimized - Loads asynchronously (doesn't block page load)
• ✅ Fast - Runs only when needed (cart changes)
• ✅ Safe - Doesn't modify your theme files

Need Help?

• Check the Troubleshooting Guide for detailed solutions
• Read the FAQ for common questions
• Contact Support if you're still having issues

Next Steps

Now that your theme extension is enabled:

• Create Your First Promotion
• Learn About Trigger Rules
• Back to Getting Started