Table of Contents
Problem Description #
The free-shipping bar is missing from (or not updating inside) the new WooCommerce Cart/Checkout Blocks, block-based cart widgets, or page-builder mini-carts.
Common symptoms
- Nothing visible in the header mini-cart or cart widget.
- The plugin appears on the standard /cart/ page but not in block-based cart or checkout templates.
- The plugin doesn’t update when cart widget content changes across the site.
Cause
- The WooCommerce Cart & Checkout Blocks (and some page-builder cart widgets) do not use the same PHP rendering hooks or update paths as classic templates; some blocks rely on REST/JS rendering. The plugin historically supported classic shortcode/cart but may need specific integration or updated compatibility for block-based carts. Support threads show this is a frequent compatibility area. WordPress.org+1
Solution (step-by-step)
- Confirm where you want the bar displayed: If you only need it on classic Cart/Checkout pages, add the plugin there (shortcode or built-in positions). If you need the bar in a header mini-cart or block widget, continue the steps.
- Check plugin settings positioning: Admin → Display Settings → choose a position that targets the block if possible (some positions are only for classic cart templates).
- Check WooCommerce Blocks version: Ensure WooCommerce Blocks and WooCommerce are updated, older Blocks versions can cause false incompatibility reports. The plugin author reported some older Blocks bugs are fixed in newer Blocks releases. WordPress.org
- If using a block-based site or theme with header cart widget: Try placing the plugin shortcode inside the same block where the mini-cart renders (if page builder permits) instead of a global header area.
- Disable aggressive caching on cart widget: If your cart widget is cached, disable caching for the cart or exclude the widget from CDN caching. Test again.
- If using a page-builder (Elementor/Divi/Oxygen):
- Make sure you’re placing the plugin output into a dynamic area which is updated by AJAX (if your page builder provides dynamic fragments).
- For Elementor: test by adding the plugin shortcode into an Elementor HTML/Text widget placed inside the Cart template.
- Make sure you’re placing the plugin output into a dynamic area which is updated by AJAX (if your page builder provides dynamic fragments).
- If you still don’t see the bar: Contact plugin support with a URL and screenshots; include theme name, page-builder name/version, and WooCommerce Blocks version. Plugin devs have investigated and provided targeted fixes in several threads. WordPress.org
- Latest WooCommerce Blocks (if using block-based cart) and plugin version.
- If possible, a staging copy for testing.
Additional Notes
- Block-based themes and the modern WooCommerce Blocks system sometimes require plugin updates to support REST-rendered cart fragments, plugin authors often patch or advise on compatible positions. WordPress.org
