Troubleshooting

I enabled the Mini Cart but don't see it

The Mini Cart needs a place: connect your theme's icon under Header Cart (Action = Mini Cart), or add [siteryn_mini_cart] to your header. See Where it appears.

My theme's cart icon doesn't open the cart

1. Is Replace WooCommerce Header Cart on, and the chosen cart (Mini or Side) enabled?
2. Does the Cart Icon Selector match your theme? See Finding your selector.
3. Clear page and CDN caches and any JavaScript optimization (combine or delay JS) that may delay the plugin's script.

The floating button doesn't appear

It needs both Enable Floating Cart Button and Enable Side Cart. With Pro, check Display Rules (hidden on the cart and checkout pages by default).

The cart doesn't update after add to cart

• For shop pages, WooCommerce → Settings → Products → "Enable AJAX add to cart buttons on archives" must be on.
• With "Redirect to the cart page after successful addition" on, WooCommerce reloads to the cart page instead.
• Some themes or plugins replace the Add to cart button with their own; check your browser console for errors.

"We could not update that item" with page caching

Cached pages older than about a day carry an expired security token. Exclude cart, checkout and My Account from the cache and keep the cache lifetime under 12 hours, or purge it daily.

The cart opens on the cart and checkout pages

Free shows the carts on every page. Pro's Display Rules hide them there by default; or use the siteryn_mcsc_render_side_cart filter (see Developer guide).

The Mini Cart ignores my Width setting on phones

On screens up to 782 px it's always 360 px wide (92% of the screen if narrower), so it fits.

The Continue Shopping button is missing

It's off by default for the Mini Cart (on for the Side Cart): turn on Show "Continue Shopping" Button on that sub-tab. With Continue Shopping Link set to Custom URL, the Continue Shopping Custom URL must be filled in.

Shadow Style on the Appearance tab has no effect

The panels' shadows come from the Shadow setting on the Mini Cart and Side Cart sub-tabs, and the floating button's from its own Shadow setting on the Floating Cart tab.

The page behind the Side Cart turns white instead of dark

The page overlay uses the Panel Tint Color from the Appearance tab, which is white by default. Lower Page Overlay Opacity (%) on the Side Cart sub-tab, or pick a darker Panel Tint Color (it also tints the panels' background when Panel Opacity is below 100%).

The "−" button stops at 1

Lowering Quantity Below 1 on the Appearance tab is set to Stops at 1: shoppers remove the item with its × link. Set it to Removes the item to let 0 remove it.

Panel titles or button texts don't change with the language

Only the Continue Shopping texts and custom URLs are translatable per language with WPML or Polylang. The panel titles, button texts and empty-cart texts you type are shown as entered in every language. See Multilingual stores.

Pro

• Tabs show "Pro preview" and no Save button, or no Quick Presets on the Appearance tab: activate your license under License.
• Badge style, close-after-remove or confirm settings ignored: turn on Enable Advanced Behavior.
• Layout, animation style, SKU or Mini Cart custom icon ignored: turn on Enable Mini/Side Cart Style. The floating button's custom icon needs Enable Floating Cart Custom Icon.
• The goal bar color didn't change after applying a preset: the preset fills Cart Goal → Progress Bar Color, which is saved with the Pro tabs; click Save Changes on the Cart Goal tab too.
• The goal bar disagrees with free shipping: it uses the subtotal before tax and coupons; see Cart goal.
• A custom SVG icon shows blank: use a simple single-color SVG without styles or gradients.
• No goal bar, coupon field or recommendations: they only show while the cart has items. Recommendations also need related products, cross-sells or upsells for what's in the cart; check Show In on each tab.
• Pressing Enter doesn't apply a coupon: shoppers need to click the Apply button.
• My theme's cart-body.php copy is ignored: Pro uses its own while licensed; see Templates.

Still stuck?

Contact Siteryn support with a screenshot of System Status, your theme name, the page address and the steps to reproduce.