The bar does not show anywhere
Work through these in order:
- WooCommerce → Free Shipping Bar → Show the free shipping bar is ticked, and at least one placement is ticked.
- A shipping zone has an enabled Free shipping method whose Free shipping requires… is A minimum order amount, with an amount above 0. If not, the settings screen says "No free-shipping rule found".
- WooCommerce shipping is enabled (WooCommerce → Settings → General → Shipping location(s) is not set to disable shipping).
- The cart holds at least one product that needs shipping. A cart of virtual or downloadable products gets no bar.
- In the free edition, the cart is not empty.
It shows for me but not for a customer
The bar uses the zone WooCommerce matches for the shopper's address. A customer whose country or postcode falls into a zone without a Free shipping method gets no bar — which is correct, because they would not get free shipping at checkout either. Check which zone their address falls into.
The amount looks wrong
The bar measures the cart exactly as the Free shipping method does: the displayed subtotal (with tax if your shop shows prices including tax), minus coupon discounts unless Apply minimum order rule before coupon discount is ticked on the method. Shipping costs are never counted. If the number surprises you, check those two settings on the Free shipping method — the checkout uses the same ones.
My free shipping needs a coupon
A rule that needs only a coupon has no amount to count towards. The free edition shows no bar for it, nor for the "amount or coupon" and "amount and coupon" rules. Full edition: an "and" rule gets the bar. An "or" rule shows no "add X more" — a coupon alone would earn free shipping, so telling a shopper to spend more would be untrue — only the congratulations message once the amount is reached or a coupon is applied. A coupon-only rule shows the congratulations message once a free-shipping coupon is applied.
The bar does not update when the cart changes
- Free edition: the bar is printed when the page loads and has no script. It updates on the next page load.
- Full edition: on the classic cart, the mini-cart and the classic checkout it refreshes through WooCommerce's own fragments. On the Cart and Checkout blocks it watches the block cart and fetches the bar again from WooCommerce's fragments endpoint whenever the totals change. If it still does not move, check that a caching or optimisation plugin is not delaying or combining the plugin's script.
Does it work with the Cart block?
Yes. On a block-based cart page the bar is printed above the Cart block. Full edition: the same for the Checkout block.
The bar does not show on my shop page
The shop placement uses WooCommerce's woocommerce_before_shop_loop hook, which fires only when there are products to list. A theme or page builder that replaces the product archive without that hook will not show it there; the cart placement is unaffected. Full edition: place the bar yourself with the block or the shortcode.
Does it work with page-cache plugins?
The bar depends on the visitor's cart. Cache plugins normally skip caching for visitors who have a cart, and always for the cart and checkout pages. Full edition: after an add-to-cart, the cart fragments refresh the bar in the mini-cart even on a cached page.
Does it work with HPOS?
Yes. Both editions declare compatibility with High-Performance Order Storage and the Cart & Checkout blocks. The bar only reads the cart and the shipping zones and writes nothing to orders.
Can I change the wording or the colours?
The free edition uses its own wording, translated into the site's language, and a small neutral stylesheet under your theme's styling. Full edition: Messages and Colors on the settings screen, with a live preview.
Will my settings carry over to the full edition?
Yes, the two the free edition has. The editions use different options (gmfb_settings and gmfsb_settings); the first time the full edition runs on a site where it has never been configured, it copies the free edition's on/off switch and its shop and cart placements into its own option, once. The mini-cart and checkout placements, which the free edition does not have, start on, and the messages and colours start at the full edition's defaults. The free edition's option is left as it was. The threshold itself is your WooCommerce shipping zone, which both editions read, so nothing about free shipping changes. Once the full edition is active the free edition stands down; deactivate and delete it.
What does uninstalling remove?
- Free edition: its one option,
gmfb_settings. It creates no tables, meta, cron events or transients. - Full edition:
gmfsb_settings, the licence optiongmfsb_license, the cached update data and the licence-check schedule. - Neither touches your shipping zones or your orders.
Can I show the bar on a page of my own?
Full edition: add the Free Shipping Bar block in the editor, or the [gatemi_free_shipping_bar] shortcode. A page holding either is skipped by the automatic placements. See the Developer reference.
