Box Rate Shipping for WooCommerce

WooCommerce calculates shipping by weight and shipping class. The courier charges for the box the parcel actually fits in. For anything bulky, those two numbers aren’t even close, and the gap eats into your margin on every order.

Three T-shirts and one kettle weigh the same, but they travel in completely different boxes. A pillow, a dog bed, a lampshade: light, but they take up as much room as a 150 UAH box.

This module closes exactly that gap. You describe the boxes you actually ship in, and the checkout shows the cost of the boxes the order genuinely fits into.

What the buyer sees

An ordinary shipping method in the cart and at checkout, with whatever name you gave it. No extra fields, popups, or steps. The order details show which boxes made up the price — for example “Small × 2”.

If a product lands in the cart that can’t be honestly calculated, the method simply isn’t shown — instead of showing a confidently wrong amount.

What the admin gets

Box table: name, length, width, height, maximum weight, cost, and a per-kilogram surcharge. Dimensions in whatever units your WooCommerce uses — nothing is converted behind your back.

Rules: what to do with a product without dimensions, what to do with an oversized item, a handling surcharge (once per shipment, not per box), free shipping above a threshold, permission to rotate items when packing.

Separately — diagnostics: a list of published products with an empty length, width, or height, with edit links. On our own test site, 39 out of 40 turned out to be like that.

How it works, step by step

1. The cart is broken down into individual physical items: three identical products are three items, each needing its own space, not one object with a quantity of 3.
2. Items are sorted from largest by volume.
3. Each item is first tried against already-open boxes — starting with the one with the least free space left, so boxes fill up instead of multiplying.
4. If it doesn’t fit any open box, the smallest box it physically fits into is opened.
5. Price = sum of the costs of the boxes used, plus weight surcharges, plus a one-off handling surcharge.

The “fits” check is not by volume. A 90 cm-long item won’t go into a 40 cm box, however much free volume is left, so every candidate is checked against all three sides. Rotating the item is optional — for products that must only travel one way up, it can be switched off.

Under the hood

The algorithm is first-fit-decreasing: largest items first, the smallest box they fit into. It’s not perfect three-dimensional packing — the perfect version is an NP-hard problem, and no checkout should be solving it. But it never claims a packing that’s physically impossible, and that property is what keeps the calculation honest.

The rotation check is done cheaply and correctly: both triples of sides are sorted and compared member by member — this covers all six orientations without enumerating them. Plus a small tolerance so a 30.0 cm item is treated as fitting a 30.0 cm box, as it would be in any warehouse.

🔴 The main decision is what to do with a product without dimensions. The most common reason a box-rate calculation produces nonsense has nothing to do with the maths: the store imported a feed that left the dimension fields empty, and half the catalogue officially has a zero size. Most modules happily treat such products as flat, and the seller finds out from the courier’s invoice.

Here, by default, the module refuses to calculate a cart containing a product without dimensions, logs the names of those products under WooCommerce → Status → Logs, and lists them on its own settings screen. Two other policies (treat as the largest box, or pack by weight only) are available — but that’s a decision you make deliberately, not a default behaviour you never saw.

Installation

1. Plugins → Add New → Upload Plugin → zip → activate. WooCommerce must be active.
2. Open Box rate in the admin menu and describe your boxes.
3. Check the warning about products without dimensions — if there is one, fix the import first.
4. Add the “Box rate” method to the relevant shipping zone: WooCommerce → Shipping.