Gatemi Side Cart FAQ and Troubleshooting

The panel does not open when I add a product

Automatic opening listens for WooCommerce's added_to_cart event, which the shop loop's AJAX Add to cart buttons fire. Check:

  1. Open automatically when a product is added to the cart is ticked.
  2. WooCommerce → Settings → Products → Enable AJAX add to cart buttons on archives is on.
  3. On a single product page, WooCommerce's standard form reloads the page rather than adding by AJAX, so there is no event: the page reloads with the product in the cart, and the floating button shows the new count.

Products shown with WooCommerce's block-based product listings add to the cart through the Store API instead of that event, so the panel does not open by itself there; the shopper can open it from the floating button after the next page load.

The side cart does not show on the cart or checkout page

By design. Those pages are the cart; a second cart over them is noise.

The side cart does not show anywhere

Check Enable the side cart is ticked. The panel is printed in the page footer, so a theme that does not call wp_footer() cannot show it. Open the browser console and look for JavaScript errors from other plugins, which can stop every script on the page.

The quantity buttons do nothing

The changes go to WooCommerce's frontend AJAX endpoint (?wc-ajax=…). A security plugin or firewall blocking those requests stops them. A page served from a full-page cache for longer than a day can carry an expired nonce; clear the cache.

Do cache plugins work with it?

Yes. The panel is refreshed through WooCommerce's cart fragments, which cache plugins built for WooCommerce already handle. The cart and checkout pages are not cached by those plugins, and the side cart is not shown on them.

Does it work with block themes and the Cart and Checkout blocks?

The panel is printed on every page through wp_footer, which block themes call too. Its View cart and Checkout buttons link to your cart and checkout pages, whichever kind they are, and the side cart steps aside on both. Both editions declare Cart and Checkout block compatibility.

Full edition: the free-shipping meter does not show

The meter only shows when the cart's shipping zone has a Free shipping method whose rule is A minimum order amount or A minimum order amount OR a coupon, with a minimum above zero, and when Show the free-shipping progress meter is on. A rule that needs a coupon, or a coupon and a minimum, gets no meter, because no amount on its own would unlock it. A shopper whose address puts them in a zone without free shipping sees no meter either.

Full edition: the coupon says "That coupon could not be applied."

WooCommerce refused it — expired, used up, a minimum not met, or not valid for these products. Try it on the cart page to see WooCommerce's own reason.

Does it work with HPOS?

Yes. The plugin works with the cart, not with stored orders, and both editions declare HPOS compatibility.

Moving from the free edition to the full edition

Install and activate the full edition. The two editions store their settings separately (gmsdcf_settings and gmsdc_settings), so set your choices again on WooCommerce → Side Cart; the full edition's defaults are the same as the free edition's — side cart on, opening on add. The cart itself is WooCommerce's, so nothing in a shopper's cart is affected. The free edition stands down while the full edition is active.

What does uninstalling remove?

  • Free edition: its one option, gmsdcf_settings.
  • Full edition: gmsdc_settings, its licence state, the cached update payload and the licence-check cron event.

Neither touches carts, orders or products.

Does it send data anywhere?

No. The free edition makes no external requests. The full edition contacts gatemi.com only for licensing and updates, once a key is entered.

Shopping Cart
Scroll to Top