Taxes
Configure tax zones and rates for your store.
Taxes are calculated automatically at checkout based on where the customer's order is being shipped. You define tax zones (geographic regions), set percentage rates for each zone, and Shopper handles the calculation for every order.
Shopper supports both tax-inclusive pricing (VAT, common in Europe where tax is included in the displayed price) and tax-exclusive pricing (sales tax, common in the US where tax is added at checkout).
Accessing Tax Settings
- Click on Settings in the sidebar
- Select Taxes from the settings menu

Creating a Tax Zone
A tax zone maps to a country (and optionally a province/state). To create one:
- Click the plus icon next to the Taxes heading. The Add tax zone panel opens
- Select the Country
- Optionally enter a Province / State code in ISO 3166-2 format (e.g., "US-CA" for California)
- Turn on Incl. tax if your prices include tax (tax-inclusive), or leave it off if tax is added at checkout (tax-exclusive)
- Click Save

Tax Zone Fields
| Field | Required | Description |
|---|---|---|
| Country | Yes | The country this tax zone applies to |
| Province / State code | No | A province or state code in ISO 3166-2 format, country code first (e.g., "US-CA", "US-NY", "FR-IDF"). Leave empty for country-wide rules |
| Name | No | A display name for this zone (e.g., "California", "Île-de-France") |
| Incl. tax | No | If ON, prices already include tax (VAT). If OFF, tax is added at checkout (sales tax). The tax zones list shows an Incl. tax or Excl. tax badge |
| Tax provider | No | Leave on System (default) to use the rates you set below. Other providers appear here once your developer has enabled them |
| Metadata | No | Optional key-value data for custom use |
Tax-Inclusive vs Tax-Exclusive
| Setting | How it works | Common in |
|---|---|---|
| Incl. tax ON | A product listed at 100 EUR already includes tax. The tax amount is extracted from the price. | Europe (VAT), Australia (GST) |
| Incl. tax OFF (Excl. tax) | A product listed at $100 has tax added on top at checkout (e.g., $100 + $10 tax = $110). | United States, Canada |
Adding Tax Rates
Each tax zone needs at least one tax rate. The default rate applies to all products in the zone unless a more specific override exists.
To add a rate:
- Select a tax zone from the list
- Click Add Rate above the Tax Rates table. A panel titled with the tax zone (e.g., "Tax rate for France") opens
- Enter the Name, Code, and Rate
- Turn on Default if this is the zone's primary rate
- Click Save

Tax Rate Fields
| Field | Required | Description |
|---|---|---|
| Name | Yes | Rate name shown on invoices (e.g., "TVA 20%", "State Sales Tax") |
| Code | No | Machine-readable identifier (e.g., "FR_VAT_STANDARD") |
| Rate | Yes | The percentage (e.g., 20 for 20%, 5.5 for 5.5%) |
| Default | No | If ON, this rate applies to all products that don't match a specific override |
| Combinable | No | Shown as "Allow this rate to stack with parent zone rates." The built-in tax calculation applies one rate per product, so this setting has no effect unless your developer has connected a tax provider that uses it |
| Metadata | No | Optional key-value data for custom use |
The Tax Rates table lists each rate with its Name, Code, Rate, Default, Targets (the number of override targets), and Combinable columns. Use the pencil icon to edit a rate and the trash icon to delete it.
Multiple Rates per Zone
Some countries have different tax rates for different types of products. For example, France has:
| Rate | Percentage | Applies to |
|---|---|---|
| Standard VAT | 20% | Most products |
| Reduced VAT | 5.5% | Food, books |
| Zero VAT | 0% | Certain essential goods |
Create each rate in the same zone. Create the standard rate with Add Rate and turn on Default: it applies to all products. Create each other rate as a rate override and pick the products, product types, or categories it applies to. A rate that is neither the default nor linked to targets is never applied.
Rate Overrides
Overrides let you apply a non-default tax rate to specific products, product types, or categories. For example, you can set food products to use the 5.5% reduced rate instead of the default 20%.
To create an override:
- Select a tax zone from the list
- Click Create Override above the Tax Rates table. A panel titled with the tax zone (e.g., "Override rate for France") opens
- Enter the Name and Rate, and optionally a Code. An override is never the default rate, so the form has no Default toggle
- Under Targets, click Add target, then choose a Target type and a Target value. Add as many targets as you need
- Click Save

Override Types
| Type | What it targets | Example |
|---|---|---|
| Product types | All products of a type (Standard, Virtual, External) | Virtual products with digital tax rate |
| Products | A specific product | A book with zero-rated VAT |
| Categories | All products in a category | Food category with reduced rate |
Best Practices
Start with Defaults
Set up one default rate per zone. Add overrides only when needed for specific product categories.
Know Your Rules
Tax rules vary by country. Consult your accountant or tax advisor for the correct rates.
Test Both Modes
Test checkout with both tax-inclusive (VAT) and tax-exclusive (sales tax) zones to verify prices display correctly.
Use Codes
Give each rate a clear code (e.g., "FR_VAT_20") for easy identification in reports and invoices.
For developer details on tax calculation, custom tax providers, and the tax pipeline, see the Taxes documentation.
Last updated on
Edit on GitHub


