Setting up Tax Rates
Tax classes are displayed at the top of the tax screen. Click one to view tax rates for the class.
In the tax rates table, you can define tax rates (one per row). Click Insert Row to get started.
Each tax rate has these attributes:
- Country Code – 2 digit country code for the rate. Use ISO 3166-1 alpha-2 codes. Leave blank (*) to apply to all countries.
- State Code – 2 digit state code for the rate. See
i18n/states/COUNTRYCODE.phpfor supported states. For the US, use a 2 digit abbreviation e.g. AL. Leave blank (*) to apply to all states.
- ZIP/Postcode – Enter postcodes for the rate. You may separate multiple values with a semi-colon (;), use wildcards to match several postcodes (e.g. PE* would match all postcodes starting with PE), and use numeric ranges (e.g. 2000-3000). Leave blank (*) to apply to all postcodes.
- City – Semi-colon separated list of cities for the rate. Leave blank (*) to apply to all cities.
- Rate % – Enter the tax rate, for example, 20.000 for a tax rate of 20%.
- Tax Name – Name your tax, e.g. VAT
- Priority – Choose a priority for this tax rate. Only 1 matching rate per priority will be used. To define multiple tax rates for a single area you need to specify a different priority per rate.
- Compound – If this rate is compound (applied on top of all prior taxes) check this box.
- Shipping – If this rate also applies to shipping, check this box.
Tax Rate Examples
Here is an example of a tax setup for a UK store — 20% for UK customers only.
In this example, we have a 6% tax rate for all US states except California, which has a 7% tax rate and a local tax rate of 2% for ZIP code 90210. Notice the priorities — this demonstrates how you can ‘layer’ rates on top of another.
Importing and exporting rates
There is an export button within the table that you can use to export a CSV of your input rates.
There is also an import function that you can use to import a CSV. The CSV requires 10 columns;
country code, state code, postcodes, cities, rate, tax name, priority, compound, shipping, tax class
Leave tax class blank for standard rates.
Below, we’ve provided a sample tax rate CSV to import for the United States based off of state tax only. This should not be used for production purposes, as tax rates frequently change. Double-check any rate for accuracy before using.
Deleting Tax Rates
If you incorrectly added tax rates or the CSV import has incorrectly added tax lines, this information needs to be deleted.
- Go to: Commerce > Settings > Tax > Your Tax Rates (Standard, Reduced Rate, Zero Rate)
- Select the incorrect lines by clicking on them. They will be highlighted in yellow.
- Select Remove Selected Rows. This will remove the highlighted rows.
- Select Save Changes.
If you want to delete all tax rates at once, use the ‘Delete all WooCommerce tax rates’ option in Commerce > System Status > Tools.>Delete All Tax Rates