Gatemi Sticky Add to Cart FAQ and Troubleshooting

The bar does not show

Check in this order:

  1. The switch. Show the sticky bar on product pages must be on.
  2. The product. It must be in stock, purchasable (published, with a price), and not an external or grouped product.
  3. Is the form still on screen? The bar only shows while the page's add-to-cart form is entirely out of view. On a short page where the form never scrolls away, there is never a bar.
  4. Is there a form? The script looks for WooCommerce's form.cart. A page builder or theme that draws its own add-to-cart button without that form leaves the script nothing to submit, so it removes the bar.
  5. Full edition: Who sees it. Small screens only hides the bar at 782 pixels and wider; Large screens only hides it below that.
  6. Full edition: a filter. Code returning false from gmsac_enabled switches the bar off for that product.

The bar's button is greyed out

That is a variable product with no variation chosen, or a chosen variation that is out of stock or not purchasable. Choose a variation on the page and the button is enabled. The real form would refuse the add anyway, and a button that submits into a validation error is worse than one that waits.

Will it add the right variation and options?

Yes. The bar's button submits the page's own add-to-cart form, so the chosen variation, the quantity and any add-on fields (from a product options plugin, for example) are sent exactly as if the shopper had pressed the page's own button, and every plugin's validation runs.

The bar appears before I scroll

On layouts where the add-to-cart form starts below the visible part of the screen — common on phones, under a tall image gallery — the form is out of view from the start, so the bar shows straight away and hides as the shopper reaches the form. That is intended: the form is out of reach in both cases.

Does it work with block themes?

Yes. Block themes' product template still prints WooCommerce's add-to-cart form. The free edition's button also carries the wp-element-button class, so a block theme styles it as one of its own buttons.

Does it work with page caching?

Yes. Nothing in the bar depends on the visitor: it is part of the page, and the full edition's screen-size choice is plain CSS. The add itself is your normal add-to-cart, so it behaves exactly as it does without the bar.

Can I hide the bar on certain products?

Full edition: yes, with the gmsac_enabled filter — see the developer reference. The free edition shows the bar on every product that qualifies.

Can I change its colours?

Yes, with CSS custom properties on .gmsacf (free) or .gmsac (full); see the developer reference. The bar switches to a dark palette when the visitor's system is in dark mode.

Does it work on the shop or category pages?

No. It is a single-product-page feature: on a list of products there is no single form for it to submit.

Does it send any data anywhere?

No. Neither edition makes external requests; the full edition talks to gatemi.com only for licence checks and updates, and only once a key is entered.

Moving from the free edition to the full edition

The two editions do not share settings, and there are only two in the free edition. Install and activate the full edition — the free one stands down while it is active — set Show the sticky bar and The price the way you had them, choose the full edition's extra options, then deactivate and delete the free edition.

What happens when I uninstall?

  • Free edition: deletes gmsacf_settings.
  • Full edition: deletes gmsac_settings, the licence state, the cached update data and the licence check event.

Neither edition writes anything to products, orders or customers.

Shopping Cart
Scroll to Top