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.

General Tax Settings

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.

The following instructions take you through the basic tax configuration for your Magento installation. Before setting up your taxes, make sure that you are familiar with the tax requirements of your locale. Then, complete the tax configuration according to your requirements.

Admin permissions can be set to restrict access to tax resources, based on the business “need to know.” To create an Admin role with access to tax settings, choose both the Sales/Tax and System/Tax resources. If setting up a website for a region that differs from your default shipping point of origin, you must also allow access to the System/Shipping resources for the role. The shipping settings determine the store tax rate that is used for catalog prices.

Configure the general tax settings

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. For a multisite configuration, set Store View to the website and store that is the target of the configuration.

  3. In the left panel, expand Sales and choose Tax.

  4. Complete the following configuration settings.

    If necessary, clear the Use System value checkbox of any settings that are dimmed.

Tax Classes

  1. Expand the Tax Classes section.

    Tax Classes

    • Tax Class for Shipping — Set to the appropriate class. The default classes are: None and Taxable Goods
    • Tax Class for Gift Options — Set to the appropriate class. The default classes are: None and Taxable Goods
    • Default Tax Class for Product — Set to the appropriate class. The default classes are: None and Taxable Goods
    • Default Tax Class for Customer — Set to the appropriate class. The default class is: Retail Customer and Wholesale Customer
  2. When complete, click Save Config.

Calculation Settings

  1. Expand the Calculation Settings section.

    Calculation Settings

  2. Set Tax Calculation Method Based On to one of the following:

    Unit Price The price of each product
    Row Total The total of the line item in the order, less discounts
    Total The order total
  3. Set Tax Calculation Based On to one of the following:

    Shipping Address The address where the order is to be shipped
    Billing Address The billing address of the customer or company
    Shipping Origin The address that is specified as the point of origin for your store.
  4. Set Catalog Prices to Excluding Tax or Including Tax.

  5. Set Shipping Prices to Excluding Tax or Including Tax.

  6. Set Apply Customer Tax to one of the following to determine whether tax is applied to the original or discounted price: After Discount or Before Discount

  7. Set Apply Discount on Prices to one of the following to determine if discounts include or exclude tax: Excluding Tax or Including Tax

  8. Set Apply Tax On to Custom price if available or Original price only.

  9. Set Enable Cross-Border Trade to one of the following:

    Yes Use consistent pricing across different tax rates. If the catalog price includes tax, choose this setting to fix the price regardless of the customer’s tax rate.
    No Vary the price by tax rate.

    Important: If cross-border trade is enabled, the profit margin changes by tax rate. Profit is determined by the formula (Revenue - CustomerVAT - CostOfGoodsSold). To enable cross-border trade, prices must be set to include tax.

  10. Expand the Default Tax Destination Calculation section and specify the country to be the default for tax calculations.

    Default Tax Destination Calculation

  11. When complete, click Save Config.

Price Display Settings

Important! Some combinations of settings related to a price display that both includes and excludes tax can be confusing to the customer. To avoid triggering a warning message, see the recommended settings.

  1. Expand the Price Display Settings section.

    Price Display Settings Price Display Settings

  2. Set Display Product Prices in Catalog to one of the following:

    Excluding Tax Catalog prices that appear in the storefront do not include tax.
    Including Tax Catalog prices in the storefront include tax only if a tax rule matches the tax origin, or if the customer’s address matches the tax rule. This might happen after a customer creates an account, logs in, or uses the Estimate Tax and Shipping tool in the cart.
    Including and Excluding Tax Catalog prices that appear in the storefront are displayed both with, and without tax.
  3. Set Display Shipping Prices to Excluding Tax, Including Tax, or Including and Excluding Tax.

  4. Expand the Shopping Cart Display Settings section.

  5. For each of the following settings, choose how you want taxes and prices to appear in the cart, according to the requirements of your store and locale:

    • Set Display Prices to Excluding Tax, Including Tax, or Including and Excluding Tax.

    • Set Display Subtotal to Excluding Tax, Including Tax, or Including and Excluding Tax.

    • Set Display Shipping Amount to Excluding Tax, Including Tax, or Including and Excluding Tax.

  6. Set the following to either Yes or No, according to your needs:

    • Include Tax in Order Total
    • Display Full Tax Summary
    • Display Zero Tax Subtotal

    Shopping Cart Display Settings

  7. Expand the Orders, Invoices, Credit Memos Display Settings section.

  8. Specify how prices and taxes appear in orders, invoices, and credit memos:

    • Set Display Prices to Excluding Tax, Including Tax, or Including and Excluding Tax.

    • Set Display Subtotal to Excluding Tax, Including Tax, or Including and Excluding Tax.

    • Set Display Shipping Amount to Excluding Tax, Including Tax, or Including and Excluding Tax.

    • Set the following to Yes or No, according to your requirements:

      • Include Tax in Order Total
      • Display Full Tax Summary
      • Display Zero Tax Subtotal

    Orders, Invoices, Credit Memos Display Settings Orders, Invoices, Credit Memos Display Settings

  9. When complete, click Save Config.