Skip to main content
If Upcart is not opening when customers add items to their cart, opens and then redirects to the cart page, a double cart appears, or one does not appear at all, this guide will help you identify and fix the issue. Most Upcart issues are caused by:
  • Upcart not being fully enabled
  • Theme cart settings
  • Enhanced AJAX API Compatibility configuration
  • Third-party apps overriding cart behavior
  • Theme cart drawers conflicting with Upcart
Follow the steps below in order and test after each change.

​
Step 1: Make Sure Upcart Is Fully Active

Before troubleshooting anything else, confirm Upcart is properly enabled.

​
1. Ensure the Cart Is Activated

If the cart is disabled inside the Upcart editor, it will not appear on your website.
  • Open Upcart
  • Go to Cart Editor
  • Confirm the cart is enabled

​
2. Enable the App Embed

If the app embed is disabled, Upcart will not load.
  • Go to Shopify Admin → Online Store → Themes → Customize
  • Open App Embeds
  • Toggle Upcart ON
  • Save
Test your cart after enabling these settings.
Activate Upcart

​
Identify Your Issue

Continue below based on what you’re experiencing:

​
Issue 1 & 2: Upcart Redirecting to the Cart Page

If Upcart briefly opens and then redirects, or customers are taken directly to the cart page, this is usually caused by:
  1. A checkout redirect setting inside Upcart
  2. Enhanced AJAX API Compatibility
  3. Theme cart redirect settings
  4. Another app forcing a redirect
Work through the steps below.

​
1. Check Checkout Button Setting in Upcart

If customers click Checkout and are sent back to the cart page:
  1. Go to Upcart → Editor → Settings → Cart Settings
  2. Locate: “Go to cart page when pressing checkout button”
  3. Turn this OFF
  4. Save
  5. Test again
When enabled, this forces the checkout button to redirect to the cart page. Checkout Cartpage

​
2. Check Enhanced AJAX API Compatibility

Go to: Upcart → Cart Editor → Settings → Advanced Settings Locate: Enhanced AJAX API Compatibility

​
Important:

This setting changes how Upcart handles Add to Cart events.
  • Disabled (recommended for most stores)
    Upcart intercepts Add to Cart calls and prevents redirects.
  • Enabled
    Upcart stops intercepting Add to Cart calls, allowing other apps to control cart behavior, including redirects.
If enabled, other apps can redirect customers to the cart page.

​
What to do:

  • If you are NOT using a bundle, customization, or subscription app that requires this setting → turn it OFF.
  • If you ARE using such an app → the redirect is likely coming from that app’s settings.
After adjusting, test your cart again. Enhanced Ajax

​
3. Change Theme Cart Type to “Page”

Your theme’s cart drawer or popup may be overriding Upcart. To fix:
  1. Go to Shopify Admin → Online Store → Themes
  2. Click Customize
  3. Open Theme Settings → Cart
  4. Change Cart Type to Page
  5. Save
Why this works:
Setting the cart to “Page” prevents the theme’s drawer from opening behind or instead of Upcart. 0984d4a6af1e Note:
If your theme does not include a “Cart Type” (or equivalent) setting, you’ll need to contact your theme developer/theme support to locate or add the correct option. Upcart can’t control theme settings.

​
4. Disable Theme Cart Redirect Settings

Some themes automatically redirect customers after adding products. To check:
  1. Go to Shopify Admin → Online Store → Themes → Customize
  2. Open Theme Settings → Products (or Cart)
  3. Look for settings like:
    • Enable cart redirection
    • Redirect to cart after add
    • Go to cart after add
  4. Turn these OFF
  5. Save
  6. Test
These settings bypass Upcart entirely.

​
5. Check for Conflicts With Other Apps

Many third-party apps override cart behavior. Common conflict apps include:
  • Some Bundle apps
  • Some Subscription apps
  • CartKit
  • Globo Product Options
  • Zepto Product Personalizer
  • PageFly
  • Replo
  • Other cart drawer apps

​
What to Look For Inside Each App

Open the app settings and look for options such as:
  • Redirect to cart
  • Go to cart after add
  • Automatically open cart page
  • Action after product is added
Change these to:
  • Stay on page
  • Do nothing
  • Use Enhanced AJAX API Compatbility
Save and test after each adjustment to identify the conflict.

​
Example – Globo Product Options

Disable:
“Redirect to the shopping cart page after adding a product”

​
Example – Zepto Product Personalizer

Go to:
Zepto → Settings → Add to Cart Settings Change:
“Action after a product is added to the cart”
To:
“Stay on the product page and show a success message”

​
Issue 4: Upcart Is Not Opening at All

If nothing happens when adding to cart or clicking the cart icon, this is usually a theme conflict.

​
Disable Theme’s Native Cart Drawer

  1. Go to Shopify Admin → Online Store → Themes → Customize
  2. Open Theme Settings → Cart
  3. Set cart type to Page
  4. Save
Ensure Drawer or Popup modes are disabled.

​
Upcart Not Detecting Your Buttons?

Some themes use custom code. If so, Upcart may not detect your Add to Cart button or Cart icon automatically. Follow these steps:

​
Step 1: Find the Class Name

  1. Open your store in Google Chrome.
  2. Right-click the Add to Cart button or Cart icon.
  3. Click Inspect.
  4. In the highlighted code, look for something like:
class="icon icon-cart"
or 
class="product-form__submit button"
Copy just one class name (for example: icon-cart). Do NOT copy class=
Do NOT copy the quotation marks You only need the class name itself. Findclass

​
Step 2: Add It in Upcart

When adding it in Upcart, you must add a dot (.) in front of the class name. For example: 
.icon-cart
Then:
  1. Open Upcart
  2. Go to Cart Editor → Settings → Advanced Settings
  3. Scroll to Selector Settings
  4. Paste .icon-cart into the correct field:
    • Open Cart Button Selector (for cart icon)
    • Add to Cart Button Selector (for add to cart button)
Use Add Additional Selector or Use Custom Selector if needed. Apply Selector

​
Additional Troubleshooting

If the issue persists: 1. Toggle Shadow DOM (ON/OFF) In some themes, Shadow DOM can affect how Upcart detects buttons and cart events.
  1. Open Upcart → Cart Editor → Settings → Advanced Settings
  2. Locate the Shadow DOM option (if available)
  3. Toggle it ON
  4. Click Save and test
  5. Toggle it OFF
  6. Click Save and test again
Use whichever setting produces consistent Upcart behavior.
2. Toggle AJAX Setting (ON/OFF) Some stores behave better when AJAX handling is switched, depending on theme and app setup.
  1. Open Upcart → Cart Editor → Settings → Advanced Settings
  2. Locate the AJAX setting (if available)
  3. Toggle it ON
  4. Click Save and test
  5. Toggle it OFF
  6. Click Save and test again
Use whichever option prevents redirects and reliably opens Upcart. 3. Clear Browser Cache - Old cached scripts may interfere.
  1. Open browser settings
  2. Go to Privacy & Security
  3. Select Clear Browsing Data
  4. Clear cached files and cookies
  5. Refresh and test
4. Test With a Default Shopify Theme
  1. Go to Shopify Admin → Online Store → Themes
  2. Add a free theme (e.g., Dawn)
  3. Enable it temporarily
  4. Test Upcart
If Upcart works with Dawn, the issue is your custom theme. 5. Disable Apps One by One
  1. Go to Shopify Admin → Apps
  2. Disable one cart-related app at a time
  3. Test after each
When Upcart starts working, you’ve identified the conflict. 6. Check Browser Console for Errors
  1. Open your store
  2. Press F12 (or right-click → Inspect)
  3. Open the Console tab
  4. Add a product to cart
  5. Look for errors (especially add.js or cart-related errors)
  6. Screenshot any errors

​
When to Contact Support

If you’ve completed all steps and Upcart still isn’t working, contact support with:
  • Theme name and version
  • List of cart-related apps installed
  • Console error screenshots
  • Steps you’ve already tried
You can reach Upcart Support: