DocumentationConfiguring feesFee title placeholders
Fee title placeholders
Five placeholders put the fee's own numbers into its label. Write "Cash on delivery ([PERCENT_AMOUNT]% + [FIXED_AMOUNT])" and the customer reads "Cash on delivery (2.5% + $0.50)" — and it stays true when you change the rule.
The five
| Placeholder | Renders as |
|---|---|
[FIXED_AMOUNT] | The fixed part, formatted as a price in the store’s currency: $0.50 |
[PERCENT_AMOUNT] | The percentage as a bare number: 2.5. Type the sign yourself: [PERCENT_AMOUNT]% |
[CART_TOTAL] | The cart subtotal the percentage is based on, as a price |
[MINIMUM_AMOUNT] | The minimum, as a price |
[MAXIMUM_AMOUNT] | The maximum, as a price |
Prices use the store’s currency, symbol position and decimals, and on a multi-currency store they are converted like the fee itself. The two cap placeholders are filled in on any rule that has a percentage. Leave a cap empty and the placeholder still renders, as an unbounded amount — not something to show a customer, so only use a cap placeholder when that cap is set. On a rule with no percentage they are left in the title as typed.
Examples
| Title | At checkout |
|---|---|
Cash on delivery ([PERCENT_AMOUNT]% + [FIXED_AMOUNT]) | Cash on delivery (2.5% + $0.50) |
Card fee, [PERCENT_AMOUNT]% of [CART_TOTAL] | Card fee, 1.4% of $110.00 |
COD fee ([PERCENT_AMOUNT]%, max [MAXIMUM_AMOUNT]) | COD fee (2.5%, max $8.00) |
Bank transfer discount | Bank transfer discount |
The last one is the reminder that a title does not have to carry numbers at all. A customer who knows what the line is for asks fewer questions than one who can recompute it.
Where the title shows
On the cart, at checkout, on the order in the admin, in every order email and on anything an invoicing plugin generates from the order. With Pro’s display controls it can also appear beside the payment method’s name at checkout, where the amount is already shown, so a short title works best there.
Translating it: register it with WPML String Translation — it is registered whenever the settings are saved. See WPML and translations.
An empty title
Leave the title empty and the fee is named after the payment method: Cash on delivery fee. On a 2.x store whose title was never set, the same happens after the upgrade.
Something the placeholders cannot say? Tell me the sentence you wanted to write.
Suggest a feature