Magento Tax Configuration — Tax Rules, Rates, VAT and Display Settings

In this tutorial, you'll learn how to configure Magento's tax system, including tax classes, rates, rules, VAT for European sales, display settings, and cross-border tax calculations.

What You'll Learn

• Understanding tax classes for products, customers, and shipping
• Creating tax zones and rates for countries, states, and postcodes
• Building tax rules that combine classes and rates
• Configuring VAT for European Union sales
• Setting up tax display settings (including/excluding tax)
• Configuring fixed product tax and WEEE Compliance
• Handling cross-border and cross-state tax calculations
• Understanding tax rounding behavior

Why It Matters

Tax configuration is the most legally consequential part of Magento setup. Incorrect tax calculations lead to underpayment, fines, and audits. Different regions have vastly different tax rules: US sales tax varies by state and zip code, EU VAT depends on customer and seller location, and some products have special tax treatment. Getting tax right in Magento protects your business from legal and financial risk.

Real-World Use

A UK-based store sells to customers in the UK, Germany, and the US. UK customers pay 20% VAT. German customers pay German VAT (19%) on digital goods but UK VAT on physical goods (distance selling rule). US customers pay no VAT but may owe state sales tax based on their shipping address. Magento's tax rules handle each scenario automatically when properly configured.

Learning Path

flowchart LR
  A["Shipping"] --> B["Tax Configuration
← You are here"]:::current
  B --> C["Orders & Invoices"]
  C --> D["Sales Rules & Coupons"]
  D --> E["Customer Accounts"]

  classDef current fill:#38bdf8,color:#0f172a,stroke-width:2px

Tax Configuration Overview

Magento's tax system has three components that work together:

1. Tax Classes — Categories that define what is taxable (products, customers, shipping)
2. Tax Zones and Rates — The actual tax percentages per geographic region
3. Tax Rules — Rules that combine classes and rates to determine the final tax

The configuration is at Stores > Taxes > Tax Zones and Rates and Stores > Taxes > Tax Rules.

Tax Classes

Tax classes categorize entities for tax purposes. Go to Stores > Taxes > Tax Classes.

Product Tax Classes:

• Taxable Goods — Default for most physical products
• None — For non-taxable items (some digital goods, food items in some regions)
• Refund Adjustment — For credit memo adjustments
• Gift Wrapping — For gift wrapping charges
• Printed Gift Card — For physical gift cards

You can create custom product tax classes for different tax treatments. For example, "Food" (0% tax in some states) and "Clothing" (reduced rate in some states).

Customer Tax Classes:

• Retail Customer — Default for individual customers
• Wholesale — For wholesale customers (may have different tax treatment)
• EU Consumer — For EU customers buying digital goods
• EU Vendor — For EU vendor scenarios

Customer tax classes let you apply different tax rates to different customer groups. For example, wholesale customers may be exempt from certain taxes.

Shipping Tax Class:

• Shipping is taxed based on the shipping tax class, which can be set to the same as products or a different rate.

Tax Zones and Rates

Tax zones define where a specific tax rate applies. Go to Stores > Taxes > Tax Zones and Rates to create rates.

Each rate has:

• Tax Identifier — Internal name (e.g., "US-CA-8.25%")
• Country — The country where this rate applies
• State — The state/region (or * for all)
• Zip/Post Code — Specific zip code or range
• Rate Percent — The tax percentage

Examples:

Rate: US-CA-8.25%
  Country: United States
  State: California
  Zip: *
  Rate: 8.2500%

Rate: US-NY-8.875%
  Country: United States
  State: New York
  Zip: *
  Rate: 8.8750%

Rate: UK-VAT-20%
  Country: United Kingdom
  State: *
  Zip: *
  Rate: 20.0000%

For US sales tax, each state has its own rate, and some states have different rates per county or city. You can create multiple rates for each zip code range.

Tax Rules

Tax rules combine tax classes with tax rates. Go to Stores > Taxes > Tax Rules to create rules.

A tax rule specifies:

1. Name — Internal rule name
2. Product Tax Classes — Which products the rule applies to
3. Customer Tax Classes — Which customers the rule applies to
4. Tax Rates — Which rates the rule uses
5. Priority — Lower numbers apply first
6. Additional VAT/Luxury Tax — For cascading taxes
7. Stop Further Processing — Stop applying rules after this one

Example rule for California retail customers:

Name: US-CA Retail Tax
Product Tax Class: Taxable Goods
Customer Tax Class: Retail Customer
Tax Rate: US-CA-8.25%
Priority: 1
Stop Further Processing: No

This rule applies 8.25% tax to Taxable Goods products purchased by Retail Customers in California.

Multiple tax rules can apply to the same product. For example, a country tax (20%) and a luxury surcharge (5%) can be separate rules applied in priority order.

VAT Configuration

VAT (Value Added Tax) is used in the European Union and many other countries.

VAT rates per country:

VAT ID validation: Magento can validate VAT IDs against the VIES (VAT Information Exchange System) database:

1. Go to Stores > Configuration > Customers > Customer Configuration > Create New Account Options.
2. Enable "Show VAT Number on Storefront."
3. Enable "Validate VAT ID with VIES."
4. Select the default customer group for valid VAT IDs (typically the group that qualifies for intra-community VAT exemption).

When a customer enters a valid VAT ID, Magento verifies it with VIES and assigns the customer to the appropriate group (e.g., "EU Business" with 0% VAT).

Intra-community VAT rules:

• B2B within EU: 0% if the buyer provides a valid VAT ID (reverse charge)
• B2C within EU: Seller's local VAT rate for physical goods (distance selling threshold: 10,000 EUR)
• B2C within EU: Buyer's country VAT rate for digital goods (Oss scheme)
• B2B and B2C outside EU: 0% VAT (export)

Tax Display Settings

Configure how tax appears on the storefront in Stores > Configuration > Sales > Tax:

Display Product Prices In Catalog:

• Excluding Tax — Base price only
• Including Tax — Final price including tax
• Both — Shows both prices (Excl. Tax / Incl. Tax)

Display Shipping Prices:

• Excluding Tax
• Including Tax
• Both

Shopping Cart Display:

• Display Prices: Excluding/Including/Both
• Display Subtotal: same
• Display Shipping: same

Orders and Invoices Display:

• Same options as cart

The choice depends on your market. EU stores typically show prices including tax. US stores typically show prices excluding tax and add it at checkout.

Default Tax Destination Calculation

Magento calculates tax based on the destination or the origin:

Origin-based tax: Used by some countries (Canada for some provinces). Tax is based on the seller's location.

Destination-based tax: Used by most regions (US sales tax, EU VAT). Tax is based on the customer's shipping address.

Configure in Stores > Configuration > Sales > Tax > Default Tax Destination Calculation:

• Default Country, State, Zip — Used when the customer has not yet entered their address
• Apply Tax on: Custom price if tax is based on origin

Fixed Product Tax (FPT)

Fixed Product Tax (also called WEEE tax) is an additional fixed amount applied to specific products, typically electronics in the EU.

Configure FPT:

1. Go to Stores > Attributes > Attributes.
2. Create a new attribute of type "Fixed Product Tax."
3. Assign to the appropriate attribute set.
4. Set the FPT amount on each product.

In Stores > Configuration > Sales > Tax > Fixed Product Taxes:

• Enable FPT
• Configure display settings: Including/Excluding/Both
• Choose whether FPT applies in the cart, on product pages, and in emails

FPT amounts are collected from the customer and paid to local recycling authorities.

Tax Rounding

Tax rounding determines how decimal amounts are handled:

Round per item: Each item's tax is rounded individually, then summed.

Round line: Each line (item qty x price) tax is rounded, then summed.

Round total: All tax amounts are summed, then rounded.

Configure in Stores > Configuration > Sales > Tax > Calculation Settings:

• Tax Calculation Method Based On: Unit Price, Row Total, or Total
• Tax Calculation Based On: Shipping Address, Billing Address, or Store Origin
• Catalog Prices: Excluding or Including Tax
• Shipping Prices: Excluding or Including Tax
• Apply Discount on Prices: Excluding or Including Tax

The rounding method affects the final tax amount. Round per unit is most accurate but can produce different results than the total method.

Cross-Border Tax

When selling across state or country borders, tax rules get complex:

US cross-state sales:

• Sales tax applies based on the customer's shipping state (destination-based)
• Some states have county and city taxes on top of state tax
• Economic nexus rules require tax collection if you exceed a certain sales volume in a state

EU cross-border sales (OSS/IOSS):

• Distance selling: Under 10,000 EUR in a year, use your local VAT rate
• Over 10,000 EUR, use the customer's country VAT rate
• The One-Stop Shop (OSS) scheme simplifies reporting

Configure multiple tax rates and rules per region to handle cross-border scenarios.

Common Mistakes

1. Not creating separate customer tax classes. Using the same customer class for retail and wholesale means both pay the same tax. Create separate classes if wholesale customers have different tax treatment or exemptions.

2. Mixing up including/excluding tax display. European customers expect prices including tax. US customers expect prices excluding tax. Setting the wrong display mode confuses customers and may be illegal in some jurisdictions.

3. Forgetting to configure VAT validation. Without VIES validation, EU business customers cannot provide VAT IDs to get reverse-charge VAT (0%). This either overcharges them or requires manual refunds.

4. Using zip codes for US sales tax without updating them. US sales tax rates change frequently. Using static tax rates by zip code means your rates will be outdated. Consider a third-party tax engine like Avalara or Vertex for automatic rate updates.

5. Overlapping tax rules. Creating multiple tax rules that apply to the same product and customer class can cause double taxation. Use priority settings and test thoroughly.

Practice Questions

1. What is the difference between product tax classes and customer tax classes? Answer: Product tax classes categorize what is being sold (Taxable Goods, Food, Clothing) for different tax rates. Customer tax classes categorize who is buying (Retail, Wholesale, Tax Exempt) for different tax treatments based on the buyer's status.

2. How does Magento determine which tax rate to apply? Answer: Magento uses tax rules that combine product tax class, customer tax class, and tax rates. The tax rate is selected based on the customer's shipping address (or billing address for digital goods). The system matches the country, state, and zip code to find the appropriate rate.

3. What is the OSS scheme and how does it affect Magento tax configuration? Answer: The One-Stop Shop (OSS) scheme allows EU sellers to report and remit VAT for all EU cross-border B2C sales in a single return. In Magento, this means configuring separate tax rates for each EU country and applying them based on the customer's shipping address.

4. Challenge: Create a complete tax configuration for a store selling to the US, UK, and Germany. The store sells physical goods (Taxable Goods class) and digital goods (Digital Goods class, 0% in US, full rate in EU). Create: tax classes for products (Taxable Goods, Digital Goods), customer classes (Retail, Wholesale, EU Business with valid VAT ID), tax rates for US (CA 8.25%, NY 8.875%, TX 8.25%), UK (20%), Germany (19%), and tax rules that apply the correct combination. Configure VAT ID validation to assign EU Business customers to the exempt group.

FAQ

{{< faq "How do I handle tax-exempt customers?" "Create a 'Tax Exempt' customer tax class with 0% tax rate. Create a tax rule that uses the Tax Exempt class. Assign tax-exempt customers to this class. Alternatively, use a {{< ilink "Magento" "Magento extension" >}} for automated tax exemption management." >}}

Mini Project

Your task: Configure a complete tax system for an international store.

1. Create product tax classes: Taxable Goods, Digital Goods, Food (0%).
2. Create customer tax classes: Retail, Wholesale, Tax Exempt.
3. Create tax rates for:
   • US: California (8.25%), New York (8.875%), Texas (8.25%)
   • UK: 20% VAT
   • Germany: 19% VAT
   • France: 20% VAT
4. Create tax rules that apply the correct class and rate combinations.
5. Configure display settings: US store shows prices excluding tax, EU store shows prices including tax.
6. Enable VAT ID validation for EU customers.
7. Create a "Tax Exempt" rule for wholesale customers with valid exemption certificates.
8. Test with:
   • US customer shipping to California
   • UK customer (retail) shipping to London
   • German customer (with VAT ID) buying digital goods
   • Tax-exempt wholesale US customer

This exercise prepares you to handle real-world tax configuration for any store.

What's Next

Now that you understand tax configuration, learn about order management:

Continue to Lesson 13: Orders, Invoices and Shipments — Complete order lifecycle.

Related lessons:

• Shipping — How shipping interacts with tax
• Sales Rules and Coupons — Discounts and their tax implications
• Cart and Checkout — Tax display during checkout