Cart Widget Troubleshooting

Solutions to common issues with the Weevio Cart Widget including display problems, estimate errors, and theme compatibility.

This page covers common issues you may encounter with the Weevio Cart Widget and how to resolve them.

Widget Not Appearing

Check the Enable Setting

Make sure enableWidget is set to true (or not set at all, since it defaults to true):

window.weevioCartConfig = {
    enableWidget: true,
    // ...
};

Verify the Shopify Domain

Open your browser console (F12) and look for this error:

Weevio Cart Widget Configuration Error: Please replace shopifyDomain with your actual Shopify domain.

If you see this, update the shopifyDomain value in your Liquid snippet from the placeholder 'your-store.myshopify.com' to your real domain.

Confirm the Snippet Is Rendered

In your browser, view the page source or inspect the DOM and search for Weevio-Cart-Widget-Root. If this element is not present, the Liquid snippet is not being rendered on your cart page. Verify that:

  • The snippet file exists at snippets/weevio-cart-widget.liquid
  • Your cart template includes {% raw %}{% render 'weevio-cart-widget' %}{% endraw %}
  • The Custom Liquid section is not hidden or disabled in the theme customizer

Check the Script Is Loading

In your browser's Network tab, filter by cart-main.js. You should see a successful request to your Weevio base URL. If the request fails or is blocked, check that:

  • The baseURL value is correct
  • Your content security policy allows scripts from the Weevio domain

Estimates Not Displaying

No Zip Code Entered

The widget requires a zip code to calculate estimates. If useStaticZipCode is not set, customers must enter their zip code using the prompt. Verify that the zip code prompt appears below the cart items.

If the prompt is not visible, the zipcodeAndDisclaimerSelector may not match any element in your theme. See Custom Selectors below.

API Errors

Open your browser's Network tab and look for requests to /api/v1/shopify/cart-widget. If these requests are failing:

  • 401/403 errors — Your Team ID or API credentials may be incorrect
  • 404 errors — The base URL may be wrong
  • 500 errors — Contact Weevio support with your Team ID and the error details

When the API encounters an error, the widget displays a toast notification at the bottom of the screen informing the customer.

Estimates Not Updating After Cart Changes

The Cart Widget uses a DOM Mutation Observer to detect when cart items change. If estimates are not updating when customers modify quantities:

  • Theme uses AJAX cart updates — The widget handles this automatically for most themes. If your theme uses a custom AJAX implementation, the mutation observer may not detect changes.
  • Cart reloads the full page — Some themes reload the entire page when the cart changes. The widget will re-initialize on page load, but estimates will reset and require a new fetch.

If you continue to experience issues, try refreshing the cart page after making changes.

Custom CSS Selectors Not Matching

The default selectors are designed for the Shopify Dawn theme:

SettingDefault Value
cartItemsSelector'.cart-item__details'
zipcodeAndDisclaimerSelector'form[action="/cart"].cart__contents.critical-hidden'

If your theme uses different markup, you need to find the correct selectors:

1

Inspect Cart Item Elements

Open your cart page and right-click on a cart line item. Select Inspect to open the browser developer tools.

Look for the container element that wraps each individual cart item's details (title, price, quantity). Note its CSS class name.

Set cartItemsSelector to that class, e.g., '.my-theme-cart-item'.

2

Inspect the Cart Form Container

Find the main cart form element, usually a <form> that wraps all cart contents. Note its CSS selector.

Set zipcodeAndDisclaimerSelector to that selector, e.g., '.cart-form-wrapper'.

3

Test the Selectors

In the browser console, run:

document.querySelectorAll('.your-cart-item-selector');

This should return one element per cart item. If it returns no elements or the wrong elements, adjust the selector.

Toast Notifications Obscured

If error toast notifications are hidden behind a sticky footer or bottom banner, increase the toastBottomOffset value:

window.weevioCartConfig = {
    toastBottomOffset: '60px',  // Adjust based on your footer height
    // ...
};

Loading Indicator Issues

Switching Loading Styles

If you prefer a cleaner loading appearance, switch from the default text animation to the skeleton loader:

window.weevioCartConfig = {
    enableLoadingText: false,  // Uses skeleton loader instead
    // ...
};

Loading Never Completes

If the loading indicator appears but never resolves to actual estimates:

  1. Check the browser Network tab for failed API requests
  2. Verify your teamID and baseURL values
  3. Ensure the Shopify domain matches your actual store
  4. Check that items in the cart have valid product data

Getting Help

If you cannot resolve the issue using the steps above:

  1. Open your browser console and note any error messages
  2. Take a screenshot of the cart page showing the issue
  3. Note your Shopify theme name and version
  4. Contact Weevio support with these details and your Team ID

Need Help?

For assistance, please send a message to our Support page.