Skip to content

Getting started with Customs

Customs calculates the EU flat import duty (3 EUR per tariff line by default) on consignments up to 150 EUR shipped from outside the EU to EU destinations. This guide walks you through installation, activation, initial configuration and verifying the fee line at checkout.

  • WordPress 6.5 or newer.
  • WooCommerce 8.0 or newer (fully compatible with High-Performance Order Storage / HPOS).
  • PHP 8.1 or newer.
  • A store shipping orders from a location outside the EU customs territory.
  1. Download the plugin zip archive or install Customs from the WordPress plugin directory.
  2. Go to Plugins > Add New > Upload Plugin in your WordPress admin panel, select the file and click Install Now.
  3. Click Activate Plugin.
  4. Navigate to WooCommerce > EU Import Duty to access the configuration screen.

To start estimating import duties on qualifying carts:

  1. Enable duty estimate: Check the box to activate the calculation on front-end cart and checkout pages.
  2. Set store origin country: Select the non-EU country where your fulfillment warehouse or shipping origin is located. If your store address in WooCommerce settings is already outside the EU, the plugin detects it automatically.
  3. Verify the duty amount and threshold: Defaults are set to 3 EUR per tariff line and 150 EUR threshold in accordance with Council Regulation (EU) 2026/382.
  4. Set your exchange rate: If your store base currency is EUR, leave the rate at 1.0. If you sell in another currency (such as USD, GBP or PLN), set the exchange rate (store currency per 1 EUR).
  5. Choose who pays the duty: Select DDP (charged at checkout, added to customer order total) or DAP (shown as an informative estimate for parcels where the delivery carrier collects customs fees).
  6. Save changes: Click Save changes at the bottom of the page.

To verify that the duty fee line appears correctly:

  1. Open your store front-end in an incognito browser window or logged-out session.
  2. Add a physical product to your cart with a value below 150 EUR (in store currency).
  3. Proceed to the checkout page.
  4. Enter an EU destination address (for example, Germany, France or Poland).
  5. Observe the order summary:
    • In DDP mode, a line labeled EU import duty (estimate) is added to the fees total.
    • In DAP mode, the estimated customs amount is disclosed without being added to the payable total.
  6. Test an order over 150 EUR or change the shipping address to a non-EU country (such as the United States or United Kingdom) to confirm that no duty fee is added.

Classic checkout and Checkout Blocks support

Section titled “Classic checkout and Checkout Blocks support”

Customs integrates with WooCommerce using the native fees API:

  • Classic shortcode checkout: The duty fee renders cleanly in the review order table alongside standard shipping and tax lines.
  • Cart and Checkout Blocks: The fee displays dynamically within the checkout block totals. In DAP mode, the notice displays on the order confirmation screen and customer emails.
  • HPOS compatibility: All calculated customs metadata, tariff line counts and payer modes are stored natively in order meta and sync cleanly with high-performance order tables.