Troubleshooting
Something not working the way you expect? Find your symptom below. Most fixes take a minute.
This page covers the most common ShapedCart problems in WooCommerce stores, grouped by what you see. Each section starts with the most likely cause.
Quick fixes
| What you see | Most likely cause | Fix |
|---|---|---|
| Adding a product goes to the cart page | WooCommerce redirects to the cart after an add | Turn off the redirect |
| Your saved changes don't show on the store | A page cache is serving the old page | Clear your cache |
| No cart icon in the header | Menu Cart is off, or no menu is picked | Check the Menu Cart |
| No floating cart | It's hidden on this page, device or while the cart is empty | Check its hide rules |
| Two carts open, or two cart icons | Your theme's or WooCommerce's own cart is also on | Use one cart |
[shaped_cart_menu] shows as text | ShapedCart is deactivated | Reactivate it |
| The cart looks different from the preview | Your theme's styles, or old custom CSS | Check styles |
Start here
If you're not sure what's wrong, these checks find most problems:
- Check ShapedCart is on. Go to ShapedCart → Settings and make sure Enable ShapedCart is on.
- Clear every cache. That includes your caching plugin, your host's cache and any CDN. Then open your store in a private browser window, which also starts with an empty cart.
- Look for another cart. Is another side cart plugin active, or does your theme have its own slide-out cart? See Two carts.
- Try a conflict test. On a staging copy of your site, or with the free Health Check & Troubleshooting plugin's troubleshooting mode, switch to a default theme like Storefront or Twenty Twenty-Five and turn off every plugin except WooCommerce and ShapedCart. If the problem goes away, turn things back on one at a time to find the one that causes it.
The cart doesn't open after Add to cart
When the ShapedCart side cart doesn't open after a shopper adds a product, the cause is usually one of these, most common first:
- WooCommerce is redirecting to the cart page. If adding a product takes you to the cart page, go to WooCommerce → Settings → Products and turn off Redirect to the cart page after successful addition. See Auto-Open → WooCommerce settings.
- Auto-open is off. Check Auto-open on add at ShapedCart → Side Cart → 1 Side cart → General → Basic Settings. See Auto-open on add.
- The product wasn't added. The cart only opens after a successful add. If WooCommerce shows an error, such as the product being out of stock or a required option not being chosen, the cart stays closed.
- A speed plugin is delaying ShapedCart's script. Options like "Delay JavaScript execution" hold the script back until the shopper moves the mouse or scrolls. Exclude
wp-content/plugins/reno-cart/assets/frontend/drawer.jsfrom them. See Compatibility → Caching. - A custom add-to-cart button doesn't tell WooCommerce's scripts. Some quick view or bundle plugins add products their own way. The cart then updates on the next page load instead. A developer can fix it with one line. See Developer Reference → Events.
- Another script on the page has an error. A JavaScript error from another plugin can stop scripts that run after it. Open your browser's developer console (F12, then Console) and look for red errors. The conflict test in Start here finds the plugin responsible.
The floating cart or menu cart doesn't open the cart
If clicking the floating cart does nothing, or the menu cart icon takes shoppers to the cart page instead of opening the side cart, ShapedCart's script isn't running on that page. The usual reasons are a speed plugin delaying or combining JavaScript, or a JavaScript error from another plugin. Both are covered in the list above.
My changes don't show up on the store
If you've changed ShapedCart settings but the store still shows the old cart, work through these:
- Did you click Save changes? ShapedCart doesn't apply anything until you save. If the Save changes button in the header is still active, your changes haven't been saved yet. See Saving your changes.
- Clear your caches. A caching plugin, your host or a CDN may be serving a copy of the page from before your change. Clear all of them.
- Check in a private window. Your own browser may have cached the page too. A private window, or a hard refresh (Ctrl + Shift + R, or Cmd + Shift + R on a Mac), rules that out.
Item counts that don't match the cart
If a shopper sees an item count or cart that doesn't match what they added, the page came from a cache. It corrects itself as soon as they change something in the cart. To stop it happening, make sure your cache skips shoppers with items in their cart. See Compatibility → Caching.
The menu cart is missing
If the ShapedCart menu cart icon doesn't appear in your header, check these in order:
- Is the Menu Cart switched on? It's off by default. Go to ShapedCart → Side Cart → 2 Triggers and switch on the Menu Cart card.
- Did you pick a menu? Under Add to Menu, choose the menu your header shows. If you're not sure which one it is, check Appearance → Menus → Manage Locations.
- Are you using a block theme? Block theme headers use the Navigation block, which Add to Menu can't reach. Use the shortcode instead. See Menu Cart → Block themes.
- Is this page hidden? The menu cart is hidden on the Checkout page by default, and on any page type you've added under Hide on.
- Is your header built with a page builder? If it doesn't use a WordPress menu, add the shortcode with the builder's shortcode element. See Compatibility → Page builders.
The shortcode shows nothing
[shaped_cart_menu] only shows the icon while the Menu Cart card is switched on and Enable ShapedCart is on. It's also hidden on any page type picked under the Menu Cart's Hide on.
The shortcode shows as text
If you see [shaped_cart_menu] or [reno_menu_cart] written out on the page, ShapedCart is deactivated. Reactivate it in Plugins → Installed Plugins. If you've removed ShapedCart for good, delete the shortcode from the page. See Uninstalling & Data.
The floating cart is missing
If the ShapedCart floating cart doesn't show, it's usually one of its own hide rules. Check them at ShapedCart → Side Cart → 2 Triggers → Floating Cart:
- The card is switched off. Switch it on.
- Hide when cart is empty is on, and your cart is empty. Add a product and it appears.
- This page type is hidden. By default the floating cart doesn't show on the Cart and Checkout pages. Check the other page types under Hide on too.
- Your screen size is unticked in Device Visibility. For example, if Desktop is unticked, you won't see it on a laptop.
- The side cart is open. The floating cart hides while the cart is open, and comes back when it closes.
- Something is covering it. A chat widget, cookie bar or "back to top" button in the same corner can sit on top of it. Move the floating cart with Position or Offset. See Floating Cart → Offset.
Two carts show up
If shoppers see two carts open, or two cart icons, something else on your store has its own cart:
- Your theme's cart. Many themes have their own header cart icon or slide-out cart. Turn it off in your theme's settings, usually in Appearance → Customize.
- WooCommerce's Mini-Cart block, in block theme headers. Remove it and use
[shaped_cart_menu]instead. See Compatibility → Themes. - Another side cart plugin. Only one side cart plugin should be active at a time. Deactivate the other one.
Styles look wrong
If the ShapedCart side cart looks different on your store than in the preview, one of these is usually why:
- The preview isn't your theme. The preview uses sample products and the admin's fonts. On your store, the cart uses your theme's font. That's expected.
- Your theme's styles are overriding ShapedCart's. Some themes style every button or link on the page. Use Custom CSS to set things back, starting your selectors with
#shaped-cart. - Custom CSS still uses RenoCart names. CSS written for RenoCart's
reno-cartclasses no longer applies. See RenoCart is now ShapedCart. - An old copy of ShapedCart's styles is cached. Clear your caches after updating the plugin. See My changes don't show up.
Problems inside the cart
A coupon won't apply
If a coupon doesn't apply in the ShapedCart side cart, the reason appears in red under the code box. It's WooCommerce's own message, for example that the code doesn't exist, has expired, or needs a minimum spend. Check the coupon's settings in Marketing → Coupons.
- Coupons are disabled. means coupons are switched off in WooCommerce → Settings → General. Turn them on, or switch off ShapedCart's Coupon field. See Coupon Field.
- Pressing Enter in the code box doesn't apply the code. Shoppers need to click the Apply button.
Quantity changes don't stick
If a quantity change or removal jumps back to what it was, the change didn't reach WooCommerce. ShapedCart makes cart changes through WooCommerce's Store API. Check that no security plugin blocks the REST API for visitors who aren't logged in. See Requirements → REST API.
Variation options don't show
Check that Show variation attributes is on, under Cart Items. The options only show for variable products, not simple ones. See Show variation attributes.
Add-on details don't show
Check that Show custom details is on, under Cart Items. Then check that the details show on your regular WooCommerce cart page. If they don't show there either, the add-on plugin isn't adding them to the cart. See Show custom details.
The low-stock badge doesn't show
Check these:
- Show low stock badge is on, under Cart Items. It's off by default.
- The product tracks stock, in its Inventory tab, and has a stock number set.
- Its stock is at or below your Show badge at or below number, and above zero.
- Reload the page. The badge shows when a page loads. After a cart change without a reload, it's hidden until the next page load. See Show low stock badge.
Admin problems
I can't see the ShapedCart menu
The ShapedCart menu is only shown to users who can manage WooCommerce, which on a standard site means Administrators and Shop Managers. It also needs WooCommerce to be active. See Installation → Who can change the settings.
Settings won't save
- One or more settings values are invalid. means one value couldn't be saved, usually a color typed by hand that isn't a valid hex code. Nothing is saved until it's fixed. See Saving your changes.
- If saving fails with another error, you may have been logged out, or a security plugin may be blocking the WordPress REST API in the admin. Reload the page, log in again, and try once more.
Still stuck?
Contact ShapedPlugin support through the support ticket form or the WordPress.org support forum. To get an answer faster, include:
- your ShapedCart, WordPress and WooCommerce versions, shown on the ShapedCart header and in Tools → Site Health → Info
- your theme, and any caching or speed plugin you use
- what you did, what you expected, and what happened instead
- a link to a page where the problem happens, if the site is public