Skip to main content
A tax rate records a percentage of tax you are required to collect, and where it applies. Each rate ties a tax category to a place, so goods carrying that category are taxed at that figure when they ship there. The figures themselves come from the tax authority in each place you sell. What you need to do is tell Spree what they are, so it applies the right rate to each order. Most stores end up with several: one per category per country, and more where a country taxes by state. For example, a store selling standard and reduced-rate goods into three countries needs six rates. To manage tax rates, navigate to Settings → Taxes, under the Selling group, and open the Rates tab. See Taxes for the whole screen.
Tax rates configure Spree’s built-in tax engine. They do not decide which engine a market uses. If you have connected an external tax provider, select it in Tax engine on each market rather than configuring rates here. The Rates tab names any market that uses a connected service, since these rates do not apply there.

​
Reviewing Your Tax Rates

The Tax rates list, showing each rate and what it applies to Each row shows:
  • Name - What the rate is called.
  • Rate - The percentage charged.
  • Applies to - The country, and the state where one is set.

​
How to Create a Tax Rate

Click Add tax rate. The Add tax rate panel
  • Name - What customers see on the tax line, so use the name they would recognise, such as VAT or Sales Tax.
  • Rate - The percentage, entered as a whole number. Enter 20 for 20%.
  • Tax category - Which products this rate taxes. Only goods carrying this category are affected.
  • Country - Where the rate applies. Leave it empty to tax every country.
  • State - Narrows the rate to one state. This field only appears once you pick a country that has states.
  • Show rate in the tax label - Adds the percentage to the tax line the customer sees, so it reads “VAT (20%)” rather than “VAT”.
Click Create tax rate.
A rate that names no country taxes every country. Leaving Country empty is occasionally what you want, but more often it is an oversight that taxes customers who should not be charged.
Whether your prices already include these taxes, or the tax is added at checkout, is set on each market with Prices include tax, not on the rate.

​
How to Edit a Tax Rate

Open the row menu and choose Edit. Changes apply to new calculations only. Orders already placed keep the tax they were charged, so correcting a rate does not rewrite your history.

​
How to Delete a Tax Rate

Open the row menu and choose Delete.
Deleting a rate stops tax being charged on its category in that location. Be sure to check that another rate covers those goods before removing one.

​
Further Reading

  • Tax Categories - The groupings a rate applies to
  • Markets - Where Prices include tax and the tax engine are set
  • Orders - How tax appears in an order’s summary