GST Pro DocsMigrate from V1 to V2
What changes, what stays the same, and how to migrate your templates from GST Pro V1 to V2 — plus rollback considerations.
Overview
GST Pro V2 introduces a new template editor, a new product/HSN setup, an updated tax service, and new e-invoice support. New installs start on V2. If your store is on V1, this guide explains what migration changes, what it preserves, and how to do it safely.
Migration is one-way in the app — there is no built-in V2 → V1 rollback. Read the rollback section before you migrate.
What changes
- Template system — V1 Liquid templates are converted to V2 templates with a structured, schema-driven editor (no-code settings, live preview). Your V1 design maps to its V2 equivalent during migration.
- Rendering — V2 fetches order data via GraphQL and supports richer metafield handling.
- Product / HSN setup — V2 uses the new product setup for HSN codes and GST rates.
- Tax service & e-invoice — V2 uses the updated tax engine and the new e-invoice flow.
- Metafield fields on templates — V1's
Label | namespace.keyformat is converted to V2's structured field definitions with proper types.
What stays the same
- Invoice numbering — your numbering format and sequence are preserved.
- GST configuration — supplier GSTIN, company name, state/place of supply, and the CGST/SGST vs IGST logic are unchanged (these live in settings, not templates).
- Email — sender configuration and sending behavior are independent of the template system.
- Your custom metafields — the same metafields are supported; V2 just discovers and types them better.
- Shop branding — logo, business name, and GSTIN continue to load at render time.
Migrate
Back up your current setup
Note your active V1 designs and any custom template tweaks, and export/screenshot a couple of recent invoices so you have a reference to compare against after migrating.
Run the migration
Start the V1 → V2 migration from the app. GST Pro reads each V1 template, maps it to the matching V2 design, converts its configuration, and creates the V2 templates for your store.
Review every document type
Generate a test invoice, packing slip, draft, and refund. Compare each against your pre- migration reference — check logo, columns, HSN/GST display, totals, and the QR block.
Re-check product HSN/GST
Confirm your products still show the right HSN codes and GST rates under the V2 product setup. See HSN codes.
Rollback
There is no automated rollback to V1. Your V1 templates remain stored after migration but are no longer used, and the app version is set to V2. Reverting would require manual intervention. Because of this, verify thoroughly on a test order before relying on V2 in production.
Result
Your store runs on V2 with converted templates, the new product setup, and the updated tax and e-invoice services — while your numbering, GST details, and email settings carry over unchanged.
Related articles
Understand the V2 template designs for invoices, packing slips, drafts, and refunds, and how the no-code editor works.
Fix the most common GST Pro issues — missing GSTIN or HSN, QR codes that don't show, email not sending, invoices not generating, and tax mismatches.