How to Configure GST in Magento
Goods and Services Tax (GST) is an important part of ecommerce operations in India. If you sell taxable products through a Magento store, configuring GST correctly helps ensure that taxes are calculated and displayed properly during shopping and checkout.
Magento does not provide a single “GST mode” that automatically determines every Indian tax scenario. Instead, GST is generally configured using Magento’s tax classes, tax rates, tax rules, customer and product tax settings, and address-based tax calculation.
For Indian stores, GST may involve different tax treatments depending on whether a transaction is intra-state or inter-state. For example, an intra-state transaction may involve CGST and SGST, while an inter-state transaction may involve IGST. The exact treatment depends on the nature and location of the transaction and applicable Indian tax rules.
This guide explains how to configure GST in Magento and how to test the resulting tax calculations.
Important: GST rules can depend on the product, seller’s registration details, place of supply, customer location, exemptions, and other factors. Use this guide as a Magento configuration reference and verify your actual tax treatment with a qualified Indian tax professional.
What Is GST?
GST stands for Goods and Services Tax. It is an indirect tax applied to the supply of goods and services in India.
For ecommerce stores, GST can affect:
- Product prices
- Customer invoices
- Checkout totals
- Shipping charges
- Tax rates
- Business reporting
- B2B and B2C transactions
Magento needs to be configured with the appropriate tax rates and rules so that the correct tax is calculated for eligible orders.
GST Types Commonly Used in India
For Magento configuration, it is useful to understand the basic GST components.
CGST
Central Goods and Services Tax (CGST) is generally applicable along with SGST/UTGST for eligible intra-state supplies.
For example, if the applicable GST rate is 18%, it may be divided as:
CGST: 9%
SGST: 9%
Total GST: 18%
SGST
State Goods and Services Tax (SGST) is generally applicable to eligible intra-state supplies.
For an 18% GST rate:
CGST: 9%
SGST: 9%
IGST
Integrated Goods and Services Tax (IGST) is generally used for eligible inter-state supplies.
For an 18% GST rate:
IGST: 18%
The actual tax treatment depends on the transaction and applicable law.
GST Rate Examples
Different products and services can have different GST rates.
For example, a hypothetical product may have:
GST Rate: 18%
Another product may have a different applicable rate.
Do not assign a GST rate based solely on the product category name. Verify the applicable GST classification and rate for the products you sell.
How Magento Handles GST
Magento’s tax system is based on several components:
Product Tax Class
↓
Customer Tax Class
↓
Tax Rule
↓
Tax Rate
↓
Customer/Shipping Address
↓
Tax Calculation
For an Indian store, you can create tax rates and rules representing the GST treatment required by your business.
Before Configuring GST
Before making changes to Magento, collect the following information:
- Business registration details
- GST registration status
- Applicable GST rates
- Product tax classifications
- Store location
- Customer locations
- Whether products are sold B2B or B2C
- Whether prices include GST
- Whether shipping is taxable
- Applicable exemptions
For businesses registered for GST, your GSTIN may also need to appear on invoices and other business documents.
Step 1: Configure the Store Country
First, make sure your Magento store has the correct country configured.
Go to:
Stores → Configuration → General → General → Country Options
Set the default country appropriately.
For an India-based store:
Default Country: India
Also review the list of allowed countries.
If you only sell within India, you may choose to restrict supported countries accordingly.
Step 2: Configure the Store Address
Your store’s origin and business address are important for tax and shipping calculations.
Navigate to:
Stores → Configuration → General → General → Store Information
Enter the appropriate:
- Store name
- Country
- Region/state
- ZIP/postal code
- Address
For example:
Country: India
State: Bihar
Postal Code: 800001
Use your actual registered business information rather than the example above.
Step 3: Configure the Product Tax Class
Go to the tax-rule management area:
Stores → Tax Rules
Depending on your Magento version, tax class management may be available from this area or through the relevant tax configuration screens.
Create or use an appropriate product tax class.
For example:
Tax Class:
GST 18% Products
However, if you sell products with different GST rates, do not create one universal class for everything.
You may instead have classes such as:
GST Standard Products
GST Reduced Rate Products
Zero-Rated Products
The actual classes should reflect your tax requirements.
Step 4: Create the GST Tax Rate
Navigate to the tax-rule management section and create a tax rate appropriate for your business.
For example:
Tax Identifier: GST 18%
Rate Percent: 18
Country: India
If Magento requires a region/state or postal code, configure it according to the geographic scope of the tax rate.
Step 5: Configure GST by State When Required
If your tax setup requires location-specific rates, Magento allows tax rates to use geographical information.
For example:
Country: India
Region: Bihar
Rate: 18%
However, do not assume that simply creating separate state tax rates automatically implements every CGST/SGST/IGST rule.
Indian GST treatment depends on the place of supply and transaction type, so more advanced stores may require carefully designed tax rules or a specialized GST extension.
Step 6: Create a GST Tax Rule
Go to:
Stores → Tax Rules
Click:
Add New Tax Rule
Give the rule a descriptive name.
For example:
Rule Name: GST 18% - Standard Products
Step 7: Select the Product Tax Class
Select the product class to which the GST rule applies.
For example:
Product Tax Class:
GST 18% Products
Only products assigned to this class should use this rule.
Step 8: Select the Customer Tax Class
Choose the customer tax class that should be covered by the rule.
For example:
Customer Tax Class:
Retail Customer
If your business has different customer categories, create appropriate customer tax classes only when required.
Step 9: Select the GST Rate
Select the appropriate GST rate.
For example:
Tax Rate:
GST 18%
The tax rule now connects:
Product Tax Class
+
Customer Tax Class
+
GST Rate
=
GST Tax Rule
Step 10: Configure Tax Calculation Settings
Go to:
Stores → Configuration → Sales → Tax
Review the tax calculation settings carefully.
Important settings may include:
- Tax Calculation Based On
- Catalog Prices
- Shipping Prices
- Apply Customer Tax
- Apply Tax On Shipping
- Tax Display Settings
- Shopping Cart Display
- Order Display
The exact options depend on your Magento version.
Configure Tax Calculation Based On
Magento can determine tax based on different addresses.
Depending on your business requirements, you may have options such as:
Shipping Address
Billing Address
Shipping Origin
For ecommerce transactions, the correct option should correspond to the applicable place-of-supply rules for your business.
Do not select an option simply because it produces the expected tax in one test order.
Configure GST-Inclusive Prices
One important decision is whether your catalog prices include GST.
Suppose a product is displayed as:
Product Price: ₹1,180
If this amount includes 18% GST, the tax component is:
Taxable Value = ₹1,000
GST = ₹180
Total = ₹1,180
Alternatively, if ₹1,000 is the price before GST:
Product Price = ₹1,000
GST = ₹180
Customer Pays = ₹1,180
Choose the Magento configuration that matches your actual pricing and invoicing approach.
Configure Tax Display in the Catalog
Magento lets you control how prices appear to customers.
Depending on your configuration, you can display prices:
- Including tax
- Excluding tax
- Including and excluding tax
For a consumer-facing Indian store, make sure the displayed price and checkout total are clear and consistent with your pricing strategy.
Configure GST on Shipping
Shipping tax requires separate consideration.
Go to:
Stores → Configuration → Sales → Tax
Review the shipping-tax settings.
If shipping is taxable under your applicable rules, configure the appropriate shipping tax class and calculation.
For example:
Product Subtotal: ₹1,000
GST: ₹180
Shipping: ₹100
The final treatment of the shipping amount should follow the applicable GST rules for your transaction.
Do not automatically apply 18% GST to shipping without verifying the correct tax treatment.
Step 11: Assign GST Tax Classes to Products
After creating your tax classes and rules, assign the appropriate class to each product.
Go to:
Catalog → Products
Open a product.
Find:
Tax Class
Select the appropriate GST-related class.
For example:
Tax Class: GST 18% Products
Save the product.
Repeat this for products that share the same GST treatment.
Managing Products with Different GST Rates
If your catalog contains products with different GST rates, create appropriate product tax classes and rules.
For example:
| Product | Tax Class | Example GST Rate |
|---|---|---|
| Product A | Standard GST | 18% |
| Product B | Reduced GST | 5% |
| Product C | Zero/Exempt | 0% |
These are only examples. Always verify the actual GST classification and rate applicable to your products.
Configuring CGST and SGST
Magento’s standard tax engine primarily works with tax rates rather than automatically presenting every Indian GST component as a separate CGST/SGST line.
For example, you may configure an overall:
GST Rate = 18%
But your invoice may need to show:
CGST = 9%
SGST = 9%
Total GST = 18%
If your business requires separate CGST and SGST presentation, you may need additional tax configuration or a Magento GST/tax extension capable of handling Indian GST-specific invoice requirements.
Do not assume that a basic 18% Magento tax rule automatically creates legally compliant CGST and SGST invoice lines.
Configuring IGST
For eligible inter-state transactions, GST may be charged as IGST rather than CGST + SGST.
For example:
Taxable Value = ₹1,000
IGST = 18%
Tax = ₹180
Total = ₹1,180
The challenge is determining whether an order is intra-state or inter-state based on the relevant business and place-of-supply information.
For stores with complex Indian GST requirements, a dedicated GST extension may be more appropriate than relying only on basic Magento tax rules.
Add GSTIN to Magento Store Information
Your business GSTIN may need to appear on invoices and other customer-facing documents.
Magento’s standard store-information settings do not necessarily provide a complete Indian GST invoice system.
Depending on your Magento edition, theme, invoice configuration, and extensions, you may need to customize invoice templates or use an extension to display:
Business Name
GSTIN
Registered Address
Tax Details
Invoice Number
Customer Details
Your final invoice should comply with the applicable Indian invoicing requirements.
How to Test GST in Magento
Never activate a new tax configuration without testing it.
Test 1: Add a Taxable Product
Add a product assigned to the appropriate GST tax class.
For example:
Product Price: ₹1,000
GST Rate: 18%
If the price excludes tax, the expected tax amount would be:
GST = ₹180
Test 2: Test the Customer Address
Enter the customer’s complete address:
Country
State
City
Postal Code
Use addresses representing the different tax scenarios your store supports.
Test 3: Verify the Tax Amount
For an 18% rate on ₹1,000:
Subtotal: ₹1,000
GST: ₹180
Grand Total: ₹1,180
The result will depend on whether your catalog prices include or exclude tax and on other Magento tax settings.
Test an Intra-State Order
For an eligible intra-state transaction, verify that your configured tax logic produces the intended treatment.
For example:
Taxable Value: ₹10,000
Total GST: 18%
If your business requires separate tax components:
CGST: 9%
SGST: 9%
Verify that the invoice displays the required information.
Test an Inter-State Order
Create another test order using an appropriate different-state shipping address.
Verify whether the order receives the intended inter-state tax treatment.
For example:
Taxable Value: ₹10,000
IGST: 18%
Do not rely on the address alone if your business’s actual place-of-supply rules require additional information.
Test GST-Exempt Products
If your catalog includes exempt or zero-rated products, assign them to the appropriate tax class.
Test the checkout:
Taxable Product → GST Applied
Zero/Exempt Product → Appropriate Tax Treatment
This ensures that your product tax classes are working correctly.
Common GST Configuration Problems
GST Is Not Appearing
Check:
- Product tax class
- Customer tax class
- Tax rate
- Tax rule
- Customer address
- Tax calculation basis
- Website scope
- Catalog tax settings
Wrong GST Rate Is Applied
Review the tax rules and make sure multiple rules are not unintentionally applying to the same products.
Also verify the product’s assigned tax class.
CGST and SGST Are Not Displayed Separately
A basic Magento tax configuration may calculate a combined GST rate without automatically creating separate CGST and SGST invoice lines.
If separate components are required, consider an appropriate GST extension or custom tax/invoice implementation.
IGST Is Not Calculated Correctly
Check how your Magento configuration determines the tax jurisdiction.
Indian GST can involve place-of-supply rules that are more complex than simply comparing two addresses.
For advanced GST requirements, a dedicated Indian GST extension may be necessary.
GST Is Included in the Product Price
Review:
Stores → Configuration → Sales → Tax
Check whether catalog prices are configured as including or excluding tax.
Also verify how the tax is displayed in the catalog, cart, checkout, and invoices.
Magento GST Best Practices
1. Keep Product Tax Classes Organized
Use clear classes based on actual GST treatment.
For example:
GST Standard
GST Reduced
GST Zero/Exempt
Do not create dozens of unnecessary classes.
2. Verify GST Rates
GST rates can change and vary by product classification.
Review your rates regularly and verify them against current official requirements.
3. Use Accurate Customer Addresses
State and postal-code information can affect tax calculations.
Make important address fields mandatory where appropriate.
4. Test Intra-State and Inter-State Orders
If your business sells across India, test both scenarios.
Do not test only one state.
5. Check Your Invoices
The amount shown at checkout should match the tax information shown on the invoice.
Review:
- Taxable value
- GST amount
- CGST
- SGST
- IGST
- GSTIN
- Invoice totals
where applicable to your business.
6. Keep GST Configuration Documented
Maintain a record of:
Product Tax Classes
Tax Rates
Tax Rules
Customer Tax Classes
GSTIN
Invoice Configuration
Effective Dates
This makes future changes easier to manage.
Example GST Configuration
Suppose a Magento store sells a product with an applicable GST rate of 18%.
The store could have:
Product Tax Class:
GST 18% Products
Customer Tax Class:
Retail Customer
Tax Rate:
India - 18%
Tax Rule:
GST 18% - Retail
If the product price is ₹5,000 excluding GST:
Product Price: ₹5,000
GST @ 18%: ₹900
Customer Total: ₹5,900
For an eligible intra-state transaction, the 18% may be represented as:
CGST: ₹450
SGST: ₹450
Total GST: ₹900
For an eligible inter-state transaction, the same total GST rate could instead be represented as:
IGST: ₹900
Whether this exact treatment applies depends on the transaction and applicable GST rules.
Frequently Asked Questions
Does Magento support GST?
Magento has a flexible tax system that can be configured for GST rates and rules. However, Indian GST requirements such as CGST/SGST/IGST handling and GST-compliant invoice presentation may require additional configuration or a specialized extension.
Can I configure an 18% GST rate?
Yes. You can create a tax rate of 18% and connect it to the appropriate product and customer tax classes through a tax rule.
Can Magento calculate CGST and SGST separately?
Basic Magento tax configuration may calculate a combined tax rate rather than automatically presenting CGST and SGST as separate components. Separate GST components may require additional configuration or an India-specific tax extension.
Can Magento calculate IGST?
Magento can calculate tax based on configured rates and addresses, but correctly implementing Indian inter-state GST logic may require additional configuration or a specialized GST solution.
Can I display GSTIN on invoices?
This may require invoice customization or a suitable extension depending on your Magento edition and existing configuration.
Can different products have different GST rates?
Yes. Use different product tax classes and corresponding tax rules for products that have different applicable GST treatments.
Should Magento prices include GST?
That depends on your pricing and invoicing requirements. Magento supports both tax-inclusive and tax-exclusive pricing configurations.
Conclusion
Configuring GST in Magento requires more than simply entering an 18% tax rate. A reliable setup should include the correct product tax classes, customer tax classes, tax rates, tax rules, address-based calculation settings, price display settings, and invoice configuration.
For a simple store, Magento’s built-in tax functionality may be sufficient for basic GST calculations. Businesses with more complex Indian GST requirements—particularly those needing accurate CGST, SGST, IGST, GSTIN, and GST-compliant invoice presentation—may need a dedicated Magento GST extension or custom implementation.
Before launching your store, test taxable products, different customer locations, intra-state and inter-state scenarios, discounts, shipping, and invoices. Most importantly, verify the final tax treatment with a qualified tax professional so that your Magento configuration matches the GST requirements applicable to your business.