Configuration
All of Surcharge lives on one screen at WooCommerce → Surcharge. This page explains every setting, what it changes on the cart, and how the options combine.
Master switch
Section titled “Master switch”A single Enable fees toggle at the top of the screen. When it is off, no fee is added to any cart — but your full configuration is kept. Use it to pause every fee at once (during a sale, while testing, or out of season) without deleting anything.
You can add as many fees as you need. Each one is independent and is evaluated separately against the cart at checkout. A fee has the following settings.
The text shoppers see in the cart and checkout totals, on the order, and in order emails. Keep it clear and specific — for example “Cash on delivery fee” or “Handling charge” — because this is the only explanation the customer gets for the extra line.
- Fixed amount — a flat value added once to the cart, in your store currency.
- Percentage — a percentage of the cart contents subtotal, calculated before existing fees and shipping. A 3% fee on a 100.00 subtotal adds 3.00.
Amount
Section titled “Amount”The number that the type acts on: a currency value for a fixed fee, or a percentage value for a percentage fee.
Taxable
Section titled “Taxable”When on, WooCommerce applies your standard tax rules to the fee, exactly as it would to a product. When off, the fee is added as a non-taxable line. Leave it off unless your accounting requires the surcharge itself to be taxed.
Conditions
Section titled “Conditions”Every condition is optional and they combine with AND — a fee applies only when all of its set conditions are met. Leave a condition blank to ignore it.
Minimum cart total
Section titled “Minimum cart total”The fee applies only when the cart total is at or above this amount. Use it to waive a handling fee on large orders, or to apply a fee only once an order is big enough to warrant it. Leave blank for no minimum.
Payment method
Section titled “Payment method”Restrict the fee to a single payment gateway. The fee appears only when the customer has that method selected at checkout, and disappears the moment they switch to another. The classic use is a Cash on Delivery surcharge. Leave blank to apply regardless of payment method.
Shipping countries
Section titled “Shipping countries”Limit the fee to one or more destinations. Enter comma-separated two-letter ISO country codes, for example US, CA, GB. The fee applies only when the shipping country is in the list. Leave blank to apply to every country.
How the options work together
Section titled “How the options work together”For each fee, Surcharge checks the master switch, then every condition you set. If the switch is on and all conditions match the current cart, the fee is added through the official WooCommerce fees API. Because it flows through Woo’s own pipeline, the fee shows correctly in cart totals, on the checkout page, on the order, in emails and in reports — no extra wiring.
Related
Section titled “Related”- Getting started — install and add your first fee.
- Fee recipes — worked examples of common fee setups.
- FAQ — answers to common questions.