Configuration

Nudge is configured on one screen: WooCommerce → Nudge. A live preview shows the bar as you change settings.

Enable bar

The master switch. When off, nothing loads on the front end. When on, the bar appears in the placements you choose — but only when there is a free-shipping goal to show and the cart is not empty.

Threshold mode

How Nudge decides the free-shipping goal:

• Automatic — reads the minimum order amount from your enabled WooCommerce free-shipping method, using the smallest qualifying amount across your shipping zones. This keeps the bar in step with your actual shipping rules; change the method and the bar follows.
• Manual — you set a fixed amount yourself, ignoring shipping methods.

If Automatic finds no qualifying free-shipping method, it falls back to the manual amount, so the bar still works while you finish configuring shipping. If there is no goal at all, the bar hides itself rather than showing a broken or always-complete state.

Placements

Where the bar renders:

• Cart — on the cart page.
• Checkout — on the checkout page.
• Both — cart and checkout.

Classic templates and the WooCommerce Cart/Checkout Blocks are both supported. For anywhere else, use the [nudge_bar] shortcode.

Messages

Two messages, both customisable:

• Progress message — shown while the shopper is below the goal. Use the {amount} token where the remaining amount should appear, for example Add {amount} more for free shipping!.
• Success message — shown once the cart reaches or exceeds the goal, for example You've unlocked free shipping!.

The {amount} token is replaced live as the cart changes.

Colours

The bar’s colours are CSS custom properties you can set in the live preview — typically a track colour, a fill (progress) colour and the text colour. The design is dark-mode aware, so it adapts to themes that switch colour schemes.

Accessibility and motion

No accessibility settings are needed. The bar is a real role="progressbar" with aria-valuenow, aria-valuemin and aria-valuemax, plus a readable text alternative, and the fill animation respects prefers-reduced-motion. The track reserves its height up front for zero layout shift.

What the shopper sees

Nudge computes the gap between the current cart total and the goal, fills the bar to match, and re-renders live as items are added or removed. Cross the goal and it switches to the success message; empty the cart or remove the goal and it hides itself.