1. Documentation
  2. Plugins
  3. WooCommerce
  4. Extensions
  5. WooCommerce Shipping & Tax

WooCommerce Tax Guide

Setup and Configuration ↑ Back to top

You can find the setup guide on the WooCommerce Shipping & Tax page. This documentation is around the Tax functionality of the WooCommerce Shipping & Tax extension. For more details around general setting up taxes in WooCommerce, please see the Setting up Taxes in WooCommerce documentation.

We recommend consulting with a tax professional to ensure your business is following regulations and best practice.

Automated Tax Calculation ↑ Back to top

To enable automated tax calculation, first ensure that “enable taxes and tax calculations” is checked on WooCommerce > Settings > General.

Automated tax calculation depends on prices to be entered exclusive of tax.

With taxes enabled, go to WooCommerce > Settings > Tax, select “Enable automated taxes” and Save Changes.

Once Automated taxes are enabled, many of the settings are disabled as Automated taxes “takes over” from the WooCommerce core tax settings. This means that “Display prices” will be set to Excluding tax and tax will be Calculated using Customer shipping address.

When Automated taxes are in use, this overrides any tax rates you have manually added, as well as the “Compound” and “Shipping” toggles for those tax rates.
After switching, we create a backup of your previous tax rates and place it in your store’s upload directory.

For stores based in the EU, we recommend using our EU VAT Number extension in addition to automated taxes.

Troubleshooting ↑ Back to top

To diagnose issues with your WooCommerce Shipping & Tax setup, go to WooCommerce > Status > WooCommerce Shipping & Tax.

If you’re experiencing issues, enable debug and/or logging.

The system status page displays issues that could cause WooCommerce Shipping & Tax to stop functioning and contains helpful debug information, plus links to get further assistance.

The most recent tax requests can be seen on the WooCommerce > Status > WooCommerce Shipping & Tax under the Taxes Log section. Older requests can be viewed by going to WooCommerce > Status > Logs.

Automated Taxes do not appear to be calculating ↑ Back to top

Even if the tax value for an order is 0.00, Automated Taxes may be working correctly. If your store is based in the United States, you only need to collect sales tax from customers in locations where you have a “tax nexus,” which typically means a physical presence. WooCommerce Shipping & Tax uses your store address (WooCommerce > Settings > General) as your “tax nexus”.

You can also have a Tax Nexus in another state if you exceed a certain yearly dollar value or order total to another state. If you are unsure of your tax nexus status, please consult a certified local accountant.

If you need to charge tax for any other state, you can add a tax rate for that state in addition to using automated taxes to charge customers from that state tax as well.

For more information about your States Tax Nexus and Destination Tax rules, please have a look at: State-by-state guide to economic nexus laws.

Moving my store to a different State ↑ Back to top

If for some reason you need to change your store address to another state, it is important that you check the settings you are using.

WooCommerce Shipping & Tax uses your store address (WooCommerce > Settings > General), so it is important that you use this setting to add the new address where your store will be located. You will also need to delete all information that you added to the Standard tax rates (WooCommerce > Settings > Standard rates tab). When using the automated rate rates, you’ll want to remove those standard rates to reset the plugin to your new location.

Error with Jetpack Authentication ↑ Back to top

01-10-2018 @ 14:09:18 - Received (401): {"statusCode":401,"error":"Unauthorized","message":"Invalid token","attributes":{"error":"Invalid token"}}
01-10-2018 @ 14:09:21 - wcc_server_error_response Error: The WooCommerce Shipping & Tax server returned: Unauthorized Invalid token ( 401 ) (fetch_service_schemas_from_connect_server)

Solution: Reconnect Jetpack. More details at: Fixing Jetpack Connection Issues.

Frequently Asked Questions ↑ Back to top

Why do I need to install and connect to Jetpack? ↑ Back to top

We use the Jetpack connection to authenticate each request and, if you use the shipping label service, to charge your credit card on file. Also, installing Jetpack gives your store additional security and stability.
If you’re still concerned about installing an additional plugin, note that once Jetpack is installed you can toggle off Jetpack modules on your site and the connection with WooCommerce Shipping & Tax would still work.

Note that data is synced with Jetpack for all modules regardless of whether they’re activated or not. You can read our Terms of Service here and information on what data is shared here

Important notice regarding California April 2019 taxes: ↑ Back to top

On April 1st, 2019, WooCommerce Tax returned lower-than-expected sales tax rates for select merchants in California and Texas. The issue was caused by a scheduled system update on our tax rate provider’s systems. They quickly identified and resolved the issue. However, some merchants based in California and Texas may have been affected.

The issue would have caused under-collection of sales tax of 1% or up to 6.5% in Texas and California, respectively.

To know if your transactions were affected, they would need to meet all of the following criteria:

Your store address is in California or Texas. You can check your store address in WooCommerce > Settings.Your store is using WooCommerce Tax. To check if the automated taxes feature is enabled look at the Automated taxes setting in WooCommerce > Settings > Tax. This tab is only visible if taxes are enabled.Your store had transactions during the affected time windows. To review your orders, go to WooCommerce > Reports and select the appropriate date range:

  • In California, we returned a lower-than-expected state rate from midnight UTC (5 pm PDT on March 31st) until the issue was resolved at 1:25 PM UTC (2:25 am PDT on April 1st.)
  • In Texas, we returned a lower-than-expected city rate from midnight UTC (7 pm CDT on March 31st) until the issue was resolved at 5:30 PM UTC (8:25 am PDT on April 1st.)

If your transactions were affected and your business uses the tax reports for reporting & filing, you likely need to manually correct the collection amount for those transactions before filing your sales tax returns. This Sales Tax Calculator could be a helpful tool.

As always, we recommend consulting with a tax professional or an accountant that can advise regarding any applicable laws to your state, country, or business. Each business is unique.

Important notice regarding EU July 1st, 2021 taxes ↑ Back to top

On July 1, 2021, new taxation rules will come into effect as part of the European Union (EU) Value-Added Tax (VAT) eCommerce package. When using WooCommerce Tax, the new changes will affect the following kinds of merchants:

  • EU merchants offering cross-border eCommerce within the EU above the EUR 10,000.00 threshold
  • Non-EU merchants selling into the EU and opting to collect the VAT during the checkout

Read more about it in the WooCommerce blog: New EU Tax Regulations: What OSS and IOSS Means for Your Store
Consult the European Commission: Modernizing VAT for cross-border eCommerce

As always, we recommend consulting with a tax professional to ensure your business is following regulations and best practice.

Questions and Support

Something missing from this documentation? Do you still have questions and need assistance?

  • Have a question before you buy this extension? Please fill out this pre-sales form – please include the name of this extension in your query.
  • Already purchased and need some assistance? Get in touch with a Happiness Engineer via the WooCommerce.com Support page and choose this extension name from the “I need help with” dropdown


The most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment