# Magento 2 VAT Switcher
### Installation and User Guide for Magento 2 VAT Switcher Extension
**Table of Contents**
1. [*Installation* ](#bkmrk-installation)
- *Installation via app/code*
- *Installation via Composer*
2. [*Configuration Settings for VAT Switcher*](#bkmrk-configuration-settin)
- *General Settings*
3. [*Show Price without VAT*](#bkmrk-order-tags-grid)
4. [*Show Price with VAT*](#bkmrk-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
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](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 .
- **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.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2026-05/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
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-09/KGTimage.png)
#### Show Price with VAT
When a user selects **“Show prices with VAT”**, all product prices are recalculated to include the applicable VAT.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-09/HYRimage.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*.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-09/VoQimage.png)
Customer groups that are not selected in the configuration settings will not have access to the VAT switcher option on the front end.
[](https://docs.scommerce-mage.com/uploads/images/gallery/2025-09/image-2025-09-08t201313-050.png)
If you have a question related to this extension please check out our [**FAQ Section**](https://www.scommerce-mage.com/magento-2-vat-switcher.html#customfaq) first. If you can't find the answer you are looking for then please contact [**support@scommerce-mage.com**](mailto:core@scommerce-mage.com)**.**