Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Nudge

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Nudge shows shoppers how far their cart is from your free-shipping threshold and how much more they need to add to reach it. The message updates as the cart changes, so “free shipping over $50” stops being fine print and becomes a number the customer can act on.

Why stores pick Nudge

Section titled “Why stores pick Nudge”

By default the threshold comes straight from WooCommerce: Nudge reads the minimum order amount from your enabled free-shipping methods across every shipping zone and uses the lowest one, so the figure is never maintained in two places. When there is nothing useful to show, the bar is disabled, the cart is empty, or no threshold is configured, Nudge renders nothing rather than an empty or always-finished bar. The free edition is the full GPL product, with one small dependency-free script.

Free edition highlights

Section titled “Free edition highlights”
  • Automatic threshold, reads the minimum order amount from your active WooCommerce free-shipping methods (the smallest across all zones, including “rest of the world”), falling back to a fixed amount you set when no qualifying method exists.
  • Cart and checkout, renders on the classic Cart/Checkout templates and on the WooCommerce Cart/Checkout Blocks; declares HPOS and Cart/Checkout Blocks compatibility.
  • Live updates, the bar is re-rendered server-side with the cart totals, so its width and message are always correct; a tiny script animates the change between renders. No jQuery of its own.
  • Accessible, a real role="progressbar" with aria-valuenow/min/max, and the message in a polite aria-live region so screen readers hear the new sentence after a cart change.
  • No layout shift, the track reserves its full height before paint, so adding the bar does not move other content.
  • Themeable, every colour, size and radius is a --nudge-* CSS custom property; the bar is dark-mode aware and respects prefers-reduced-motion.
  • Editable messages, write the progress message (with an {amount} token for the remaining total) and a separate success message for when the goal is reached.
  • Ships a POT file and removes its two options on uninstall.

How the bar works

Section titled “How the bar works”

Nudge computes the gap between the current cart total and the free-shipping goal, sets the fill width and message accordingly, and lets WooCommerce re-render the bar whenever the cart totals update. Below the goal it shows the progress message with the remaining amount substituted in; at or above the goal it switches to the success message. With no goal or an empty cart it outputs nothing.

Editions

Section titled “Editions”
  • Free on WordPress.org, automatic or manual threshold, cart and checkout placement, editable messages, themeable colours, accessible markup.
  • Pro is planned. There is no released Pro build yet, so this documentation covers the free edition only.

Next steps

Section titled “Next steps”