Skip to content
WPPoland Documentation

Nudge

Nudge shows customers exactly how close they are to free shipping — and how much more they need to add to unlock it. As the cart changes, the bar updates live, turning “free shipping over $50” from fine print into a clear, motivating goal that lifts average order value.

Why stores pick Nudge

Section titled “Why stores pick Nudge”

Nudge reads your free-shipping goal automatically from your WooCommerce free-shipping method’s minimum order amount. No method configured yet? Set a fixed amount instead. When there is no goal to show, or the cart is empty, Nudge hides itself rather than render a broken bar. The free edition is the full GPL product, with a tiny dependency-free script.

Highlights

Section titled “Highlights”
  • Automatic threshold — reads the minimum order amount from your active WooCommerce free-shipping method (the smallest across your shipping zones), with a manual fallback.
  • Live updates — the bar re-renders with the cart and animates smoothly, using a tiny script with no jQuery of its own.
  • Cart and checkout — shows on both classic and Cart/Checkout Blocks, plus a [nudge_bar] shortcode for anywhere.
  • Accessible — a real role="progressbar" with aria-valuenow/min/max and a readable text alternative; respects prefers-reduced-motion.
  • No layout shift — the track reserves its height up front (zero CLS).
  • Themeable — colours are CSS custom properties; dark-mode aware.
  • Customisable messages — use the {amount} token in the progress message and a separate success message when the goal is reached.
  • Translation ready (POT included), clean uninstall, HPOS + Blocks compatible.

How the bar works

Section titled “How the bar works”

Nudge calculates the gap between the current cart total and the free-shipping goal, then renders a progress bar with a message. As the cart changes, the bar re-renders live. When the goal is reached it switches to the success message; when there is no goal or the cart is empty, it hides itself.

Editions

Section titled “Editions”
  • Free on WordPress.org — automatic or manual threshold, live updates, cart/checkout/shortcode, customisable messages and colours.
  • Pro (planned) for per-zone goals, tiered rewards, gift thresholds and conversion analytics.

Next steps

Section titled “Next steps”
  • Getting started — install, set the threshold, choose where the bar shows.