WooCommerce shipping regression testing

What should you retest after a WooCommerce change?

A regression is something that worked before but breaks after a change. Run the same test carts again and check that WooCommerce still shows the saved shipping options and prices.

Published · Updated · Shipping Contract Guard

The risk

A correct-looking setting can still give the wrong result

A WooCommerce update, shipping-plugin update, theme change, zone edit, coupon rule, product change, or promotion can change which shipping options appear. The settings can look reasonable while Free Shipping disappears, a paid option appears too early, a price changes, or no option remains.

Save the correct result for a test cart, then compare the same cart after the change. You do not need a real customer, order, or carrier password.

Why are no shipping options available after an update?

The update may have changed which zone matches, disabled or replaced a method, changed a method condition, or exposed stale cart data. First rerun one previously working cart without changing its products, address, amount, or coupon. Then check the seven no-shipping-option causes in order.

If the method still appears but its price changed, repeat the single-class and mixed carts in the shipping-class checklist.

1

Choose carts where the result should change

Include the amounts immediately below, at, and above each important free-shipping minimum. Add the coupons, postcodes, quantities, shipping classes, and mixed carts that your rules use. Use made-up addresses, never customer addresses.

2

Save exact shipping options and prices

Save each shipping option and price, not only the name customers see. Two options can both be called “Free shipping,” so the exact option matters.

3

Run the same checks after each store change

Repeat them after WooCommerce, WordPress, theme, shipping extension, zone, shipping option, coupon, promotion, and product changes. Keep the saved correct result until a manager deliberately approves a new one.

4

Do not count an unfinished check as a pass

A timeout, unsupported shipping option, missing plugin or setting, or incomplete calculation belongs under “Could not verify.” Find out why the check stopped before assuming checkout works.

5

Run the carts again after the fix

After changing a setting, rerun the same carts. Treat the problem as fixed only when the correct shipping options and prices return. The successful retest records what was checked and when it started working again.

A simple example

Free shipping from EUR 75

Before a change, save the correct shipping options and prices for EUR 74.99, EUR 75.00, and EUR 75.01. After the change, rerun those exact carts. If Free Shipping begins at EUR 90 instead, the difference is visible immediately.

See the complete threshold example →

Changes worth testing
  • WooCommerce or WordPress update
  • Shipping plugin or theme update
  • Zone or shipping-option edit
  • Coupon or promotion change
  • Shipping class or product change

Save and rerun the checks in WordPress

Shipping Contract Guard asks WooCommerce for shipping options and prices without creating an order. All checks you run yourself are free and require no account.

Install free from WordPress.org