> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Upcart Not Opening or Redirecting to Cart Page

> Complete troubleshooting guide for when Upcart doesn't open or redirects to the Shopify cart page instead of showing the drawer.

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 the Manage all carts
* Confirm the cart is published

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

<img src="https://mintcdn.com/aftersell/xo1WZYRs2XYJ_75c/images/upcart.gif?s=5b54cb2d0e04ec09f0e27756529263f4" alt="Upcart" width="2044" height="1080" data-path="images/upcart.gif" />

***

# Identify Your Issue

Continue below based on what you're experiencing:

* [Issue 1: Upcart opens briefly, then redirects to the cart page](#issue-1-&-2-upcart-redirecting-to-the-cart-page)
* [Issue 2: Customers are redirected to the cart page instead of seeing Upcart](#issue-1-&-2-upcart-redirecting-to-the-cart-page)
* [Issue 3: Two carts are opening (Upcart and the theme cart)](#3-change-theme-cart-type-to-"page")
* [Issue 4: Upcart is not opening at all](#issue-4-upcart-is-not-opening-at-all)

***

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

<img src="https://mintcdn.com/aftersell/LTYtQf76SCq3QU1l/images/upcart/Checkout-cartpage.gif?s=3a160ebe2a0d2cd3b1c3898166baba2f" alt="Checkout Cartpage" width="1180" height="1080" data-path="images/upcart/Checkout-cartpage.gif" />

***

## 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:

This setting is **disabled by default** for most stores. Enable it ONLY if your store uses a non-standard AJAX cart API and Upcart is not intercepting add-to-cart events. When enabled, other apps gain more control over cart behavior, which can cause redirect loops or send customers to the Shopify cart page instead of opening the Upcart drawer. If enabling this setting causes redirects, disable it and use the manual Upcart API (`upcartRegisterAddToCart`) instead.

For complete guidance on this setting, see [Enhanced AJAX API Compatibility](/upcart/enhanced_ajax_api_compatibility).

After adjusting, test your cart again.

<img src="https://mintcdn.com/aftersell/LTYtQf76SCq3QU1l/images/upcart/EnhancedAjax.gif?s=2bd5cb57a927f8e632806a9804efeee7" alt="Enhanced Ajax" width="2084" height="1080" data-path="images/upcart/EnhancedAjax.gif" />

***

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

<img src="https://mintcdn.com/aftersell/44S6gABa85nCHEE3/images/upcart/0984d4a6af1e.gif?s=195d1cdb2ecbb7eee990472fa8f7b7ee" alt="0984d4a6af1e" width="644" height="1080" data-path="images/upcart/0984d4a6af1e.gif" />

**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:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

or

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
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.

<img src="https://mintcdn.com/aftersell/557MIYx3zAGipSs_/images/Findclass.gif?s=541b82b9a62178c211332abba992a8e4" alt="Findclass" width="1600" height="1080" data-path="images/Findclass.gif" />

***

## Step 2: Add It in Upcart

When adding it in Upcart, you must add a **dot (.)** in front of the class name.

For example:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
.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.

<img src="https://mintcdn.com/aftersell/OIiA4pymfmDbsiFJ/images/apply-selector.gif?s=072d5724276d13a5a2bffa27dbe07cec" alt="Apply Selector" width="1064" height="1080" data-path="images/apply-selector.gif" />

# **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:

* Through in-app chat
* Or via email at [**support@upcart.app**](mailto:support@upcart.app)

***