Skip to main content

​
Overview

This setting helps improve compatibility with apps or themes that require full control over how items are added to the cart. It disables Upcart’s built-in Add to Cart handling to avoid conflicts.

​
Where to Find It

Upcart > Editor > Settings > Advanced Settings
Look for “Enhanced Ajax API Compatibility.”

​
How It Works

Upcart maintains full control over the Add to Cart process. This ensures consistent behavior and allows Upcart to prevent other apps or scripts from overriding the cart flow. This is the recommended setting for most stores. Keep this disabled unless you are experiencing specific issues where Upcart is not intercepting add-to-cart events from your theme or other apps.

​
Enabled

Upcart will no longer manage the Add to Cart process. This allows other apps, custom JavaScript, or your theme to modify the cart without interference. Enable this setting ONLY when:
  • Your store uses a non-standard AJAX cart API
  • Upcart is not intercepting add-to-cart events from your theme or other apps
  • You need third-party apps to have direct control over cart behavior
Important trade-offs when enabled:
  • Other apps can redirect customers to the Shopify cart page instead of opening the Upcart drawer
  • You may experience redirect loops or unexpected cart behavior
  • Upcart cannot prevent external apps from altering cart behavior
If enabling causes redirect loops:
  1. Disable this setting
  2. Use the manual Upcart API (upcartRegisterAddToCart) instead
  3. See integration guides for specific apps (e.g., Replo)

​
Testing

After changing this setting:
  1. Click Save
  2. Test adding products to your cart
  3. Verify the Upcart drawer opens correctly
  4. Check that you’re not redirected to the Shopify cart page
If you experience issues after enabling, disable the setting and contact support for alternative solutions.