Everything you need to set up the progress bar, floating bar, and threshold upsells.
Requirements
- WordPress 6.6 or newer
- WooCommerce (active)
- PHP 8.1 or newer
Getting started
- Go to Plugins → Add New → Upload Plugin and upload the plugin zip, then activate it.
- Open Sproutient → Settings from the admin menu.
- Set your Free shipping threshold to match your WooCommerce free-shipping minimum.
- Turn on the placements you want — cart, mini-cart, floating bar — and save.
Tip: the bar’s threshold is a display target. To actually grant free shipping, set a matching minimum-order-amount on a Free Shipping method in WooCommerce → Settings → Shipping.
Settings reference
Threshold
- Free shipping threshold — the cart total (in your store currency) at which shipping becomes free.
Messages
- Progress message — shown below the threshold. Use
{remaining}as a placeholder for the amount left, e.g. “Add {remaining} more to get FREE shipping!” - Success message — shown once the shopper qualifies.
Appearance
- Bar colour — the progress-fill colour. The rest of the bar inherits your theme.
Placement
- Show in cart — the bar on the cart page (classic and block).
- Show in mini-cart — the bar in the mini-cart / cart drawer.
- Floating bar — a bar pinned to the edge of the screen as shoppers browse.
Floating bar options
- Position — bottom or top of the screen.
- Show everywhere — on every page. Turn off to choose specific page types.
- Home / Shop / Product / Category & tag — per-page-type toggles used when “Show everywhere” is off.
The floating bar appears only once the cart has items.
Threshold upsells
- Suggest products to reach free shipping — show suggested products on the cart page.
- How many to show — 1 to 6 products.
- Upsell heading — the text shown above the suggestions.
How the upsell suggestions are chosen
Suggestions are picked automatically from your catalogue. Only purchasable, in-stock, simple products that aren’t already in the cart are considered.
- If a single product can close the gap on its own, the cheapest such products are shown — one add qualifies, with minimal over-spend.
- If no single product is enough, a small set of the priciest products that together clear the gap is shown.
Cart compatibility
On the classic cart and mini-cart, the bar is rendered by WooCommerce and refreshes with the cart. On the block cart and mini-cart, it reads the live cart data store and repaints instantly as items change — no page reload.
Troubleshooting
The bar isn’t showing
- Confirm WooCommerce is active and the threshold is greater than 0.
- Check the placement toggle for where you’re looking (cart, mini-cart, or floating).
- The floating bar only appears once the cart has at least one item.
- If you use a caching plugin, clear the cache after changing settings.
No upsell products appear
Suggestions require products that can help close the gap. If your threshold is much higher than your product prices (for example a $1,500 threshold on a store where the most expensive item is $130), and the cart is nearly empty, the remaining gap can exceed everything in your catalogue. Lower the threshold to a realistic level for your catalogue, or add higher-priced products.
The floating bar overlaps my theme’s header or footer
Switch the floating bar position (top ↔ bottom), or restrict it to specific page types under Floating bar options.