ERPNext v16.50: what's new and how to install or upgrade safely
Short answer: v16.50 is a large update to version 16 of Frappe Framework, ERPNext and Frappe HR, announced on 7 October 2026. It isn't a new major version: it lives on the same version-16 branch. A fresh v16 installation already gets v16.50 or later, and an existing v16 site gets it with a backup and bench update. The main changes are a new navigation (Apps, then Modules, then documents), a new print format designer, a faster kanban board, a new data import wizard and saved list view layouts.
What's new in v16.50
Frappe described v16.50 as a "polished v16", focused on user experience after feedback that UI and UX were users' biggest pain point. According to the official announcement:
- New navigation: the desktop shows app icons; each app has a dock of modules, and each module has a sidebar of frequently used links. Sidebars can be customised for the whole site or per user.
- New print format designer: a drag-and-drop canvas with live preview, used for the new default print formats in ERPNext and Frappe HR.
- DocType Settings: one place for a document type's naming, workflow, print formats, email templates, notifications, roles and permissions.
- New data import wizard: step by step, with value mapping, skipping invalid rows, tree structures, and importing customers or suppliers together with their addresses and contacts in one file.
- Faster kanban boards: configurable cards, hover previews, bulk drag-and-drop and swim lanes.
- Saved list view layouts: columns, order, filters and sorting saved for yourself or for all users.
- Child tables: resizable and sticky columns, and bulk editing of selected rows.
- Other polish: a redesigned email composer, inline previews of attachments, and an updated setup wizard.
Frappe also said more v16 releases are planned for November and December, with module-specific improvements such as better customer and supplier forms, a customer and supplier portal, and dashboards backed by Insights.
Is v16.50 a new version to install separately?
No. Version numbers like 16.50 are releases on the version-16 branch. When you install ERPNext v16 today with --branch version-16, you get the latest v16 release, which is 16.50 or newer. Follow our ERPNext v16 installation guide, then check the version:
bench version
The output lists each app (frappe, erpnext, hrms) with its version; all should be 16.50 or higher.
How to upgrade an existing v16 site to v16.50
Frappe recommends upgrading all three apps (Framework, ERPNext and Frappe HR) to 16.50 or higher together, along with other installed apps such as Builder.
1. Take a full backup
bench --site erp.yourdomain.com backup --with-files
Copy the backup files off the server before you continue.
2. Test on a copy first
Restore the backup on a staging bench and upgrade that first. Check your custom fields, custom print formats, reports and any custom apps.
3. Update
bench update
bench version
bench update pulls the latest v16 release of every app, runs database migrations and rebuilds assets.
4. Opt in to the new desktop
On upgraded sites, the new desktop and sidebar layout is opt-in. Switch to the new "Apps" layout, or keep the old one, in Desktop Settings.
What to check after upgrading
| Area | Why | What to do |
|---|---|---|
| Custom fields | Frappe says some form cleanups in v16.50 may have moved custom fields | Open your most-used forms and check custom field positions |
| Permissions | The ERPNext v16.50.0 release notes list stricter user permission checks for records used in accounting, stock, assets, manufacturing and projects, and role changes for some document types | Log in as users with restricted roles and test daily tasks |
| Print formats | New default print formats and designer | Print an invoice, quotation and delivery note; adjust your custom formats if needed |
| Custom and third-party apps | Apps may need updates for the new UI | Update them to versions that support v16.50+ |
Frequently asked questions
What is ERPNext v16.50?
A large update to ERPNext, Frappe Framework and Frappe HR version 16, announced on 7 October 2026, with new navigation, a print format designer, a data import wizard, faster kanban boards and saved list view layouts.
Is ERPNext v16.50 the same as v17?
No. v16.50 is a release of version 16. Frappe's announcement said there is no v17 yet.
Does v16.50 have breaking changes?
Frappe said it kept breaking changes to a minimum, except some form cleanups that may move custom fields. The ERPNext release notes also list stricter permission checks, so test custom fields and user roles on a staging copy before upgrading.
How do I upgrade from v15 straight to v16.50?
Upgrade to version 16 (which needs Python 3.14, Node 24 and MariaDB 11.8), and you'll get the latest v16 release. See the upgrade section of our v16 installation guide.
Sources
- Frappe Blog: Announcing Framework, ERPNext and Frappe HR v16.50 (7 October 2026)
- Frappe Forum: (Officially) Announcing v16.50
- GitHub: ERPNext v16.50.0 release notes
Want help upgrading safely, with a staging test and rollback plan? See our ERPNext implementation and support service.
Need help with this?
Get honest advice and a clear quote from our team. No obligation.

