Compatibility
Requirements
| Requirement | Version |
|---|---|
| WordPress | 6.0 or newer (tested up to 7.0) |
| WooCommerce | 7.0 or newer (tested up to 10.8) |
| PHP | 7.4 or newer |
WooCommerce is a hard requirement — the plugin declares Requires Plugins: woocommerce, so WordPress will not activate it without WooCommerce present. The Pro add-on additionally requires the free plugin at a matching minimum version and tells you if the free plugin needs updating first.
High-Performance Order Storage (HPOS)
The plugin declares full HPOS compatibility. Order capture, the orders-list IOSS column, the order meta box, refund handling, monthly aggregation, and recalculation all use WooCommerce’s CRUD APIs, so they behave identically on HPOS (the modern default) and legacy post-based storage, including compatibility/sync mode.
Classic and block checkout
- Classic checkout: fully supported. Destination VAT via the IOSS Import VAT tax class, exemption toggling on address and cart changes, and both customer notices rendered inline.
- Block checkout: supported. Tax charging and exemption work through WooCommerce’s tax system, which is checkout-agnostic. The customer notices are delivered via WooCommerce’s notice system, so they appear in the block checkout’s notice area rather than as inline elements — a placement difference, not a functional one.
The Pro VIES VAT-number field is a classic-checkout field and a block-checkout contact field, following the same pattern as our OSS plugin.
Currency
Non-EUR stores are a first-class case — ECB conversion ships in the free plugin. The plugin reads each order’s recorded currency and totals, so display-only currency switchers do not affect capture. True multi-currency setups (where the order is placed in a currency other than the store base) are converted from the order’s actual currency at the captured ECB rate.
Other VAT and tax plugins
The plugin owns one thing at checkout: the IOSS boundary. If another plugin or an external tax service also charges EU VAT, run this plugin in record-only mode so the EUR 150 logic is not applied twice. VAT-number field plugins coexist — collected numbers feed the B2B exclusion. See Troubleshooting for the conflict checklist.
Multisite
The plugin works on multisite with per-site activation: each site has its own settings, IOSS number, captured data, and monthly figures. There is no network-wide dashboard — which matches the tax reality, since each store is its own supplier with its own return. Network activation simply activates it on every site; each still needs its own setup. A Pro (single-site) license covers one site in the network; Agency covers up to 10 sites.
External requests
For transparency, the complete list of outbound requests the plugin can make:
- The ECB’s public daily exchange-rate file, once a day (required for non-EUR stores).
- The optional VAT data feed URL, weekly, only if you configure one under Settings.
- Pro only: weekly license validation against Lemon Squeezy.
None of these carry information about your store, orders, or customers.
Something not covered?
If you hit an incompatibility with a specific plugin or host, contact support with the plugin name and versions — verified findings get added to this page.