Submitted for reviewFree · WooCommerce

Shipping Rules Tester for WooCommerce.

Check which zone and local rates match a sample package. Find out why a method isn't returning a rate, without changing your shipping settings.

AP Shipping Rules Tester is awaiting WordPress.org review. Source code is available now; the directory install link will follow approval.

  • WordPress 6.6+
  • PHP 7.4+
  • WooCommerce required
Shipping Rules Tester destination fields, package value and weight inputs, and quick scenario presets
The scenario builder in version 1.2.0. Select the image to view it full size.
From destination to diagnosis

A shipping check in three steps.

  1. Set the destination

    Use the address details a customer would enter. Change the postcode or state to investigate zone boundaries.

  2. Build the package

    Enter a value, weight, and quantity, select a saved product, or open the advanced builder for multiple items.

  3. Read and compare

    Choose Test shipping rules. Review the matched zone and method results, then keep the result to compare another scenario.

What you can check

Less guessing about shipping rules.

Find the matching zone

Enter a country, state, postcode, and city. See which shipping zone WooCommerce selects and the location rules behind it.

Check local shipping rates

Calculate built-in flat rate, free shipping, and local pickup where sample-package data is enough. See explanations for disabled, no-rate, or skipped methods.

Use products from your store

Read a saved product’s price, weight, dimensions, shipping class, and tax class without editing the product.

Build a mixed package

Add multiple synthetic items or saved products with per-item quantities. Include shipping classes and dimensions for more detailed checks.

Start with a quick scenario

Choose a standard order, free-shipping check, heavy parcel, or local pickup preset. Adjust the destination and package to fit your store.

Compare results side by side

Keep a result and run another test with a different destination or package. Comparisons stay in the current browser tab, with nothing saved to your database.

Read the result, not just the rate

See why a method was skipped.

A missing rate doesn't always mean a broken rule. Some methods need information a sample package can't provide.

  • Unexpected zone? Compare nearby postcodes and inspect the matched zone's location rules.
  • Free shipping missing? Compare package values around your configured threshold. Rules that need coupon or live-cart data are skipped.
  • Different product, different rate? Use a saved product's shipping class and compare it with another package.

Local checks only. External carrier rates, coupons, customer roles, subscriptions, and live-cart behavior need a separate checkout test.

Example results showing a fallback shipping zone, a matched flat rate, and a free-shipping method skipped because it needs live cart or coupon context
Example store configuration: one local rate returned, one method skipped. Your rates depend on your settings.
Run it in your store admin

Setup and requirements.

You'll need WordPress 6.6+, PHP 7.4+, and an active WooCommerce installation. The tester works with HPOS and uses your store's currency and weight unit.

While directory review is pending, use the source repository's installation instructions for a manual setup.

Read the installation instructions on GitHub
  1. Install and activate WooCommerce if it isn't already active.
  2. Place the plugin folder in wp-content/plugins/, following the repository instructions.
  3. Activate AP Shipping Rules Tester for WooCommerce from the Plugins screen.
  4. Open WooCommerce > Shipping Rules Tester and run your first sample package.
A few useful answers

Shipping tester questions

Is Shipping Rules Tester available on WordPress.org?

The plugin has been submitted for review. A WordPress.org install link will be added here after approval. You can view the source and installation instructions on GitHub now.

Will a test change my shipping settings or create an order?

No. The tester reads your current configuration and calculates a sample result. It does not change shipping settings, products, orders, or customers. Test inputs and results are not saved.

Which shipping methods can I test?

The tester supports built-in flat rate, free shipping, and local pickup when they can be calculated from a sample package. Methods that need live cart data or an external provider are marked as skipped, with an explanation.

Does it fetch live rates from shipping carriers?

No. External shipping providers are never called. Test carrier rates and integrations separately at your store checkout.

Can I use saved products and compare destinations?

Yes. Select a saved product to use its price, weight, dimensions, shipping class, and tax class. You can also build a multi-item package. Choose Keep result and test another to compare scenarios in the current browser tab. Comparisons clear when you leave the page or choose Clear comparison.

Does this replace a real checkout test?

No. Sample packages don't include coupons, customer roles, subscriptions, or live-cart state. Use the tester to investigate local shipping rules, then check the full customer journey at checkout.

What does my store need to run it?

WordPress 6.6 or later, PHP 7.4 or later, and an active WooCommerce installation. It works with HPOS because it does not depend on order storage. Package values use your store currency and weights use your configured weight unit.

Have a shipping rule to investigate?

Read the source and try a local check. If a result needs explaining, tell us which method and package you're testing.