Skip to content

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

  1. Click on Settings in the sidebar
  2. Select Taxes from the settings menu
Tax settings page

Creating a Tax Zone

A tax zone maps to a country (and optionally a province/state). To create one:

  1. Click the plus icon next to the Taxes heading. The Add tax zone panel opens
  2. Select the Country
  3. Optionally enter a Province / State code in ISO 3166-2 format (e.g., "US-CA" for California)
  4. Turn on Incl. tax if your prices include tax (tax-inclusive), or leave it off if tax is added at checkout (tax-exclusive)
  5. Click Save
Create tax zone form

Tax Zone Fields

FieldRequiredDescription
CountryYesThe country this tax zone applies to
Province / State codeNoA 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
NameNoA display name for this zone (e.g., "California", "Île-de-France")
Incl. taxNoIf 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 providerNoLeave on System (default) to use the rates you set below. Other providers appear here once your developer has enabled them
MetadataNoOptional key-value data for custom use

Tax-Inclusive vs Tax-Exclusive

SettingHow it worksCommon in
Incl. tax ONA 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:

  1. Select a tax zone from the list
  2. Click Add Rate above the Tax Rates table. A panel titled with the tax zone (e.g., "Tax rate for France") opens
  3. Enter the Name, Code, and Rate
  4. Turn on Default if this is the zone's primary rate
  5. Click Save
Add tax rate form

Tax Rate Fields

FieldRequiredDescription
NameYesRate name shown on invoices (e.g., "TVA 20%", "State Sales Tax")
CodeNoMachine-readable identifier (e.g., "FR_VAT_STANDARD")
RateYesThe percentage (e.g., 20 for 20%, 5.5 for 5.5%)
DefaultNoIf ON, this rate applies to all products that don't match a specific override
CombinableNoShown 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
MetadataNoOptional 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:

RatePercentageApplies to
Standard VAT20%Most products
Reduced VAT5.5%Food, books
Zero VAT0%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:

  1. Select a tax zone from the list
  2. Click Create Override above the Tax Rates table. A panel titled with the tax zone (e.g., "Override rate for France") opens
  3. Enter the Name and Rate, and optionally a Code. An override is never the default rate, so the form has no Default toggle
  4. Under Targets, click Add target, then choose a Target type and a Target value. Add as many targets as you need
  5. Click Save
Tax rate override form

Override Types

TypeWhat it targetsExample
Product typesAll products of a type (Standard, Virtual, External)Virtual products with digital tax rate
ProductsA specific productA book with zero-rated VAT
CategoriesAll products in a categoryFood 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