Change Cart Type in Theme

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.

​

Overview

This guide helps you troubleshoot situations where Upcart does not open or customers are redirected to the cart page instead of seeing the Upcart drawer. Most of these issues are caused by theme cart type settings, Enhanced AJAX API Compatibility configuration, third-party app redirects, or checkout button routing.

---

​

What Cart Type to Choose

Before diving into troubleshooting, check your theme’s cart type setting first as this is the most common cause.

• Page - This is usually the best option since Upcart intercepts requests to the /cart page.
• Drawer - Select this if Upcart fails to launch and the /cart page is being triggered instead.
• Confirmation Popup - Use this if your theme supports it and the other options do not resolve the issue.

Testing both options only takes a few minutes, but Page is typically the most effective choice.

​

How to Change Cart Type in Your Theme

1. Go to Online Store > Themes > Customize in your Shopify admin.
2. Open Theme Settings > Cart > Cart Type.
3. Choose either Page or Drawer based on the behavior you are troubleshooting.
4. Save your changes and test the cart on your storefront.

---

​

Troubleshooting Steps

If changing the cart type does not resolve the issue, work through the following steps in order.

​

1. Check Enhanced AJAX API Compatibility

This setting controls how Upcart handles Add to Cart events and is one of the most common causes of redirect issues.

1. Go to Upcart > Cart Editor > Settings > Advanced Settings.
2. Locate Enhanced AJAX API Compatibility.
3. This setting is disabled by default for most stores. When disabled, Upcart intercepts Add to Cart calls and prevents redirects.
4. If it is enabled, other apps can take control of cart behavior and redirect customers to the cart page. Try disabling it and test.
5. If disabling it causes other issues, re-enable it and use the manual Upcart API (upcartRegisterAddToCart) instead.

For full guidance on this setting, see Enhanced AJAX API Compatibility.

​

2. Check for Third-Party App Redirects

Many third-party apps override cart behavior and can redirect customers away from the Upcart drawer. If your Add to Cart button is specifically sending customers to the cart page, see Why Does ‘Add to Cart’ Go to the Cart Page Instead of Upcart? for more detail. Open the settings of any cart-related apps 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 or Do nothing. Common app-specific fixes:

• PageFly - Disable redirection rules in the PageFly app settings.
• Globo Product Options - Deactivate auto-redirection to Shopify’s cart.
• Replo - Adjust the “go to page” settings to enable the cart drawer.
• Zepto Product Personalizer - Go to Zepto > Settings > Add to Cart Settings and change “Action after a product is added to the cart” to “Stay on the product page and show a success message.”

If you are unsure which app is causing the conflict, disable cart-related apps one at a time and test after each until Upcart starts working correctly.

​

3. Check Checkout Button Routing

If customers click the checkout button inside Upcart and are redirected to the cart page instead of checkout:

1. Go to Upcart > Cart Editor > Settings > Cart Settings.
2. Locate “Go to cart page when pressing checkout button”.
3. Turn this OFF.
4. Save and test.

​

4. Check Theme Cart Redirect Settings

Some themes automatically redirect customers after adding a product, bypassing Upcart entirely.

1. Go to 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 and test.

​

5. Clear Browser Cache

Old cached scripts can retain previous cart behavior and prevent Upcart from loading correctly.

1. Open your browser settings.
2. Go to Privacy and Security.
3. Select Clear Browsing Data.
4. Clear cached images, files, and cookies.
5. Refresh your store and test.

​

6. Test With a Default Shopify Theme

If the issue persists, temporarily switch to a default Shopify theme such as Dawn to rule out a theme-specific conflict.

1. Go to Shopify Admin > Online Store > Themes.
2. Add and enable a free theme like Dawn.
3. Test Upcart on the default theme.

If Upcart works correctly on Dawn, the issue is with your custom theme. Contact your theme developer for assistance.

---

​

Preventative Measures

• Review configurations after updates - Theme and app updates can reset or override cart settings. Check your cart type and app configurations after any major update.
• Test app compatibility before installing - Before adding new third-party apps, confirm they are compatible with Upcart.
• Use a Draft theme for testing - Test changes on a Draft theme before publishing to avoid disrupting your live store. See Enabling Upcart in a Draft Theme Only for instructions.

---

​

Frequently Asked Questions

---

Need help? If you have worked through all the steps above and the issue persists, reach out to our support team via the in-app chat or by emailing support@upcart.app.