Three rules decide everything the plugin does.
Rule 1: two numbers, not one
A cost that always multiplied by quantity would charge £30 to post three t-shirts that go in one envelope. A cost that never multiplied would charge £10 to post thirty. So every product carries two numbers:
- Shipping cost — the first unit.
- Each additional — every unit after it.
Leave the second empty and it equals the first, which is an ordinary per-item cost. Type 0 and the rest of the line rides free.
A line costs: first + each additional × (quantity − 1).
Where a product's cost comes from
The plugin asks in this order and stops at the first answer:
- Full edition: the variation's own cost.
- The product's own cost. A variation with no cost of its own uses its product's.
- Full edition: the cost on the product's shipping class.
- The shop-wide fallback.
- Nothing — the product is unpriced.
The free edition goes straight from the product (step 2) to the fallback (step 4). It never reads a variation's own cost or a shipping class's cost, even if the full edition wrote one.
Rule 2: an unpriced product means no rate
This is the completeness rule, and it is the reason the plugin exists.
Picture a cart holding a lamp with a £12 cost and a rug nobody priced. A plugin that treats the rug as £0 quotes £12. The shopper pays it, and you post the rug at your own expense. Nothing looks wrong on your screen, because your test cart had a cost on everything.
So here, one unpriced product makes the whole package unquotable:
- The method offers no rate at all for that cart.
- WooCommerce shows whatever else the zone offers.
- If the zone has nothing else, WooCommerce shows its usual "no shipping options" message.
- WooCommerce → Per-Product Shipping lists the products that need a cost.
If you really want everything else to ship free, type 0 into the shop-wide fallback. That is a decision you made, not one the plugin made for you.
Products that do not need shipping (virtual and downloadable products) are never counted, so a cart with one downloadable beside its stock is quoted normally.
Rule 3: a real shipping method
"Per-product shipping" is an ordinary WooCommerce shipping method added to a zone. It does not rewrite the rates other plugins return. That means:
- it sits beside flat rate, free shipping and anything else in the zone;
- you can add it to one zone and not another;
- it works with WooCommerce's rate cache.
WooCommerce keys its rate cache on the cart's products and quantities. A cost you type on a product does not change that key, so the plugin clears WooCommerce's shipping cache whenever a product is saved or the settings change (and, in the full edition, when a shipping class's cost changes). Otherwise a shopper could keep seeing the old rate.
The flow at the cart
- WooCommerce works out which zone the shopper's address matches.
- For each item that needs shipping, the plugin finds its cost (above).
- Any unpriced item ends the quote: no rate is offered.
- Otherwise the line totals are added up.
- Full edition: the limits are applied:
- if the goods come to at least Free when the goods come to, the rate is 0;
- otherwise the total is raised to Never charge less than and lowered to Never charge more than.
- The rate is offered with the zone instance's Name and Tax status. A rate of 0 is still offered — that is free delivery, and the shopper can choose it.
Why free-over ignores the postage
"Free delivery over £50" is a promise about what somebody bought. The threshold is measured against the line subtotals of the goods in the package. Adding the postage would let an expensive delivery be the thing that qualifies an order for free delivery.
A worked example (full edition)
Settings: no fallback, floor £3, ceiling £20, free over £100.
| Item | Cost source | Quantity | Line |
|---|---|---|---|
| T-shirt | product: 4.00 / 0 | 3 | 4.00 |
| Poster, "Large" variation | variation: 6.00 / 2.00 | 2 | 8.00 |
| Glass vase | shipping class "Fragile": 9.00 | 1 | 9.00 |
Total 21.00, lowered to the ceiling: £20.00. If the goods came to £100 or more, the rate would be £0.00. Add a product with no cost anywhere and no rate is offered.
Uninstalling
Deleting the plugin removes the shop-wide settings. It never removes a product's or shipping class's cost: what it costs to send a thing is a fact about the thing. See the FAQ for the details.
