Skip to content

Configuration

All of Tipping’s settings live on one screen, WooCommerce → Tipping. The control is opt-in by default and renders nothing until you enable and configure it.

The master switch. While off, nothing renders on the storefront. Turn it on to show the tip control wherever you place it. If the control is enabled but misconfigured (for example presets are missing), it gracefully renders nothing rather than showing a broken widget.

How the preset buttons are calculated:

  • Fixed amounts — each preset is a flat currency value (for example 2, 5, 10 in your store currency).
  • Percentage of the cart — each preset is a percentage of the order (for example 5%, 10%, 15%), calculated from the cart subtotal.

The list of amounts shoppers can pick, interpreted according to the preset type. Keep the list short — three or four options are easiest to scan.

Which option is selected when the control first appears. The recommended default is No tip, which keeps tipping fully opt-in: the customer pays nothing extra unless they actively choose to. You can set a preset as the default if you prefer, but a non-zero default is no longer strictly opt-in.

Adds an input so a shopper can enter their own figure instead of choosing a preset — useful for generous customers or donations where any amount is welcome.

Where the control appears:

  • Cart page
  • Checkout page
  • Both

Checkout is the most common placement, since it sits right before payment. Showing it on the cart as well gives shoppers an earlier chance to add a tip.

The copy shoppers see — a heading and an explanatory line. Tailor it to your context: “Add a tip for the team”, “Support our work”, “Round up for charity”. Clear copy is what turns the control from a mystery fee into an inviting option.

Off by default, because most tips and donations are not taxed. Enable it only if your jurisdiction requires tax on tips. When on, the tip fee is treated as taxable; when off, it is added without tax.

  • Choosing an amount recalculates the order totals through WooCommerce’s own checkout AJAX, so the customer always sees the up-to-date total before paying.
  • A percentage preset is calculated from the cart subtotal at the moment of selection and recalculated whenever the cart changes, so it always reflects the current order.
  • The tip is added as a native WooCommerce cart fee, so it appears in the order totals, emails and reports. The amount is also saved as order meta for auditing.

The control is keyboard friendly with focus-visible styles, exposes an ARIA live status as totals update, and respects prefers-reduced-motion. Tipping is HPOS (Custom Order Tables) and Cart/Checkout Blocks compatible, translation ready (a POT file is included), and uninstalls cleanly with no custom database tables.