Landed Cost for WooCommerce

Learn about our custom Duty and Tax module.

Using the WooCommerce Duty and Tax module will allow the following:

  • Zonos will calculate a total landed cost (including duties, taxes, fees, and shipping), then insert it directly into your native checkout. We will itemize duties and taxes separately from shipping costs.
  • Orders will appear both in Dashboard and in WooCommerce.
  • Order status and tracking numbers will sync from Dashboard to WooCommerce.

How we integrate 

WooCommerce is a customizable platform. This means that a one-size-fits-all integration, like a plugin, doesn't work very well on WooCommerce. Instead, our engineers have created a customizable module to make integration easy for you. Our engineers will review your store's custom setup in WooCommerce, add our WooCommerce Duty and Tax module and adjust the code to accommodate your store.



Create and configure a Zonos account

  1. Register for a Dashboard account.
  2. After registering, complete your Account setup.

Install the Duty and Tax module

The Duty and Tax module is only available for installation through our Professional Services team. Our engineers will install the Landed Cost module for you once you start onboarding with your Project Manager in onboarding.


Optional—Add your product information

Product information like weight and dimensions can automatically be used in our calculations if you have them present in WooCommerce or Catalog.

However information like HS codes, country of origin, and item restrictions must be either entered in Catalog, or mapped to attributes that you set up in WooCommerce. To map this product information in WooCommerce:

  1. Create the custom attribute in WooCommerce using the slug in the table below to allow us to recognize it in our mapping.
  2. After creating the attributes for your store, go into your product listings and add the attributes with their values, using the table below. Instructions for how to add custom attributes to product listings are at the bottom of the article above.
  3. Item restrctions require a third step: Zonos will need to write a rule on our end to restrict the items you have set as restricted in WooCommerce. Please let us know if you are setting up item restrictions in WooCommerce so that we can complete this step.
Hs codehs_codeThe HS code example: 1234.56.7890
Country of origincountry_of_originTwo letter ISO code of the country example: CA
Item restrictionint_restrictThe word "restrict" for any product that you want to restrict

Configure the Duty and Tax module in WooCommerce

Our engineers will adjust the settings as needed. They will work with your Project Manager if they have any questions for you.


Test your integration

Now that you have set up your account and your module, you are ready to test it by doing the following:

Test duty and tax quotes

  1. Add item(s) to your cart. We recommend using a higher value (above the de minimis) to ensure that duties and taxes will be due for the order.
  2. Click Checkout.
  3. Add an international address to your checkout.
  4. If set up correctly, you will see a duty and tax quote below the shipping cost in the order summary.

Test order flow through your systems

  1. Place an order on your site for testing purposes.
  2. Follow your test order through your systems for fulfillment, label printing, and finances to ensure there are no conflicts.

If you print your labels from Dashboard

  1. Confirm labels will generate successfully by printing a test label. If you have multiple carriers enabled, print a label for each carrier. You can void your label after printing it, then use the same order to test more labels.

    • If you receive an error when printing a label in the Dashboard, learn how to resolve label errors.
  2. Once tested, void the label, then cancel and refund your test order.

After completing testing, you are now ready to go live. Let your Project Manager know when you are ready, and they can enable the Duty and Tax module for you!


Below is an example of a native WooCommerce checkout using the WooCommerce Duty and Tax module. Since WooCommerce is customizable, your checkout may look different from the one below.

Example of a WooCommerce store showing duties and taxes in

Frequently asked questions 

What product details are passed to Zonos from WooCommerce?

Product-specific information is not required for Zonos to return a quote. However, the more product-specific information provided, the more accurate our calculations will be. The most helpful product details for improved accuracy are listed below.

Find out which product info is received from WooCommerce, needs a custom attribute, or is not received at all and Catalog is recommended.

  • Weights - Received from WooCommerce.
  • Dimensions - Received from WooCommerce.
  • HS codes - Create a custom attribute in the app or use Catalog.
  • Country of origin - Create a custom attribute in the app or use Catalog.

Learn more.

Was this page helpful?

© 2023