

Tax Rates

- Name: A label for storefront and internal display
- Tax Category: Which group of products this rate applies to
- Zone: Where the tax applies (configured separately in the Zones section)
- Amount: The tax percentage (e.g., 20%)
- Included in Price: Whether this tax is part of the listed price
- Show rate in label: Whether this tax rate appears as part of the price label on the storefront
- Add new tax rates
- Edit existing tax rates
Tax rates in Spree rely on the Zones feature to determine where each rate applies. Zones define geographic regions (like countries or states), allowing you to target specific tax rules based on a customer’s shipping address.
Add a New Tax Rate
To add a new tax rate click New Tax Rate in the top right corner, and you’ll be directed to a tax rate creation form.
- Name
- Zone (select from existing zones)
- Tax Category (select from existing Tax Categories)
- Amount (e.g., for 5% enter 0.05)
- Included in Price (Yes/No)
- Show Rate in Label (Yes/No)
Edit a Tax Rate
To edit a tax rate, simply click on the tax rate’s row in the Tax Rates overview.
Changing a tax rate will affect all future orders using that rate, but not past orders.
Delete a Tax Rate
To delete a Tax Rate, simply navigate to the edit form for the Tax Rate you wish to delete, and click the ‘Delete’ button on the lower righthand side.Tax Categories

- Name: e.g., Standard, Reduced, Exempt
- Tax Code: Optional code for integrations or accounting
- Description: Internal notes on what this category covers
- Default: Whether this is the default category for new products
- Add new tax categories
- Edit existing tax categories
Add a New Tax Category
To add a new tax category click New Tax Category in the top right corner, and you’ll be directed to a tax category creation form.
- Name
- Tax Code (optional)
- Description (optional)
- Default (Yes/No)
Edit a Tax Category
To edit a tax category, simply click on the tax category’s row in the Tax Categories overview.
You can switch the default tax category if needed, but only one can be default at a time.
Delete a Tax Category
To delete a tax category, simply navigate to the edit form for the tax category you wish to delete, and click the ‘Delete’ button on the lower righthand side.Complex Tax Rules & Integrations
Spree supports tax extensions and API integrations with services like:- TaxJar
- Avalara
- Custom logic via Spree’s extensible tax calculator system