Customize free-shipping display, messages, and colors
The module has five presentation settings:
- Show in mini cart;
- Progress message;
- Success message;
- Progress bar color;
- Progress track color.
The mini-cart option is disabled by default. The two messages are translatable POM Framework values.
Progress placeholders
Use these tokens in Progress message:
| Placeholder | Output |
|---|---|
{remaining} |
Formatted amount still required |
{threshold} |
Free-shipping minimum amount |
{percentage} |
Rounded progress percentage |
Default:
Add {remaining} more to get free shipping.The success message is used only when WooCommerce reports the Free shipping method as available. For an “amount and coupon” method, the module appends its own coupon requirement; do not hard-code that sentence into the progress message.
Configure
- Enable Show in mini cart only if the progress should also appear in classic mini-cart templates and WooCommerce Mini-Cart blocks.
- Write a concise progress message containing at least
{remaining}. - Write a success message that does not promise dispatch time or delivery speed.
- Choose bar and track colors with sufficient contrast.
- Save and update the cart.
- Test long translations and currencies with different symbol positions. If the mini-cart option is enabled, also test narrow mini carts.
The progress element exposes its percentage to assistive technology. Keep the visible message meaningful without relying on color or bar length alone.
If invalid color values are unavailable at runtime, the module uses its green bar and light-gray track defaults.