ERPNext Upgrade Guide: Moving Between Major Versions Safely
How to upgrade ERPNext between major versions: inventory apps, handle features moved to separate apps, test on staging and run the production upgrade.
ERP platform · ERPNext
Overview
The risk is volume, not capability. A year of well-meant tweaks — a field here, a server script there — leaves a system nobody fully understands. We customise with restraint, document every change, and keep it all in a form that can be rebuilt and reviewed.
ERP Builders is an independent ERPNext services company and is not affiliated with or endorsed by Frappe Technologies. “ERPNext” and “Frappe” are trademarks of Frappe Technologies Pvt. Ltd.
01
We use the lightest tool that solves the problem, and climb only when we need to.
Labels, mandatory fields, defaults, naming series and form layout — no code, upgrade-safe.
Approval states by role and amount, email and system notifications, and assignment rules.
Invoices, delivery notes and quotations designed in the builder or in Jinja for full control, including tax-compliant layouts.
Small validations, defaults and calculations. Useful, but kept few, named clearly and exported to Git.
02
If your ERPNext has accumulated undocumented custom fields, conflicting scripts or modified standard print formats, we inventory every customisation, decide what to keep, remove or consolidate, and move what remains into a custom app as fixtures.
The result is the same behaviour your users rely on, with a clear record of what was changed and why — and a much safer path to the next upgrade.
Related
Insights
How to upgrade ERPNext between major versions: inventory apps, handle features moved to separate apps, test on staging and run the production upgrade.
How ERPNext manufacturing works: BOMs, workstations, production plans, work orders, job cards, backflushing, subcontracting, quality and costing.
How to move from Tally to ERPNext: mapping ledgers, GST details, stock items and godowns, loading opening balances, picking a cutover date and reconciling.
FAQ
Custom fields, property setters, workflows and print formats made through the standard tools survive upgrades. Scripts may need adjustment if the standard fields or functions they rely on change between versions.
We create a copy and customise that rather than editing the standard format, so upgrades do not overwrite your changes.
When logic spans several documents, needs to be fast at volume, calls external systems, or would be costly if it failed silently. At that point it belongs in a tested custom app.
Comparisons
Next step
Share the changes you have in mind and we will recommend the lightest way to make them.