Skip to main content

Magento 2 VAT Switcher

Installation and User Guide for Magento 2 VAT Switcher Extension

Table of Contents

  1. Installation
    • Installation via app/code
    • Installation via Composer
  2. Configuration Settings for VAT Switcher
    • General Settings
  3. Show Price without VAT
  4. Show Price with VAT

Installation

  • Installation via app/code: Upload the content of the module to your root folder. This will not overwrite the existing Magento folder or files, only the new contents will be added. After the successful upload of the package, run below commands on Magento 2 root directory.

    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy
  • Installation via Composer: Please follow the guide provided in the below link to complete the installation via composer.

https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer

Configuration Settings for VAT Switcher

Go to Admin > Stores > Configuration > Scommerce Configuration > VAT Switcher

General Settings

  • Enabled – Select "Yes" or "No" to enable or disable the module.
  • License Key – Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at support@scommerce-mage.com.
  • Customer Groups - Select a customer group from the available options. The VAT Switcher is accessible only to users who belong to customer groups with explicitly granted access.
  • Include VAT by Default - This setting determines whether product prices are shown inclusive or exclusive of VAT by default. 

    If set to "Yes", prices will be displayed with VAT included.

  • Customer Groups Defaults - Please add the Per Customer group default for VAT Switcher. This configuration allows the Admin to define a default VAT display preference per Customer Group. A dynamic grid is provided where each row contains:
    • A dropdown listing all Magento Customer Groups
    • A dropdown to select the Default VAT (Included/Excluded)

       

      When a customer logs in, the module checks their Customer Group ID and automatically applies the mapped VAT preference. If no mapping exists, the system falls back to the global default VAT setting. If the customer manually changes the VAT toggle, their manual choice overrides the default for the session.

     

  • Use Frontend Switcher - Select "Yes" to Switch prices on the frontend level. When this setting is enabled, the VAT toggle on the frontend becomes active and allows customers to switch between prices with VAT and prices without VAT. without refreshing or reloading the page.


    image.png


Show Price without VAT 

The VAT switcher is prominently displayed on all product listing and product detail pages. It is positioned within the header.

When a user selects “Show prices without VAT”, all product prices are dynamically updated to exclude applicable VAT.

VAT rates are calculated based on the customer’s shipping address or the store’s default tax zone. Displayed prices accurately reflect tax inclusion or exclusion in accordance with Magento’s tax configuration settings.

From the backend, administrators can fully manage VAT switcher behavior, including:

  • Enabling or disabling the VAT switcher

  • Setting the default display mode (inclusive or exclusive) per store view

  • Defining which customer groups have access to the switcher

image.png

Show Price with VAT

When a user selects “Show prices with VAT”, all product prices are recalculated to include the applicable VAT.

    image.png

    Customer Groups

    You can set a customer group by going to Admin > Customers, then choosing a customer and picking a group in the 'Group' field. The available groups include: Not Logged In, General, Wholesale, and Retailer.

    image.png

    Customer groups that are not selected in the configuration settings will not have access to the VAT switcher option on the front end.

    image - 2025-09-08T201313.050.png

    If you have a question related to this extension please check out our FAQ Section first. If you can't find the answer you are looking for then please contact support@scommerce-mage.com.