After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.

Tax Rules

This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support. The documentation available here is intended for historical reference only and is not maintained. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

Tax rules incorporate a combination of product class, customer class and tax rate. Each customer is assigned to a customer class, and each product is assigned a product class. Magento analyzes the shopping cart of each customer and calculates the appropriate tax according to the customer and product classes, and the region (based on the customer’s shipping address, billing address or shipping origin).

When numerous taxes must be defined, you can simplify the process by importing them.

Tax Rules

Step 1: Complete the tax rule information

  1. On the Admin sidebar, go to Stores > Taxes > Tax Rules.

  2. In the upper-right corner, click Add New Tax Rule.

  3. Under Tax Rule Information, enter a Name for the new rule.

  4. Choose the Tax Rate that applies to the rule.

    If you need to edit an existing tax rate, do the following:

    • Hover over the tax rate and click the Edit icon.

    • Update the form as needed and click Save.

    Tax Rule Information

  5. To enter tax rates, use either of the following methods:

Method 1: Enter tax rates manually

  1. Click Add New Tax Rate.

  2. Complete the form as needed (see Tax Zones and Rates).

  3. When complete, click Save.

    New Tax Rate

Method 2: Import tax rates

  1. Scroll down to the section at the bottom of the page.

  2. To import tax rates, do the following:

    • Click Choose File and navigate to the CSV file with the tax rates to be imported.

    • Click Import Tax Rates.

  3. To export tax rates, click Export Tax Rates (see Import/Export Tax Rates).

Import / Export Tax Rates

Step 2: Complete the additional settings

  1. Click Additional Settings to open the section.

  2. Choose the Customer Tax Class to which the rule applies.

    • To edit a customer tax class, click the edit icon, update the form as needed, and click Save.

    • To create a new tax class, click Add New Tax Class, complete the form as needed, and click Save.

  3. Choose the Product Tax Class to which the rule applies.

    • To edit a product tax class, click the edit icon, update the form as needed, and click Save.

    • To create a new tax class, click Add New Tax Class, complete the form as needed, and click Save.

  4. When more than one tax applies, enter a number to indicate the priority of this tax for Priority.

    If two tax rules with the same priority apply, the taxes are added together. If two taxes with different priority settings apply, the taxes are compounded.

  5. If you want taxes to be based on the order subtotal, select the Calculate off Subtotal Only checkbox.

  6. For Sort Order, enter a number to indicate the order of this tax rule when listed with others.

    Additional Settings

  7. When complete, click Save Rule.