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

AreaWhyWhat to do
Custom fieldsFrappe says some form cleanups in v16.50 may have moved custom fieldsOpen your most-used forms and check custom field positions
PermissionsThe 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 typesLog in as users with restricted roles and test daily tasks
Print formatsNew default print formats and designerPrint an invoice, quotation and delivery note; adjust your custom formats if needed
Custom and third-party appsApps may need updates for the new UIUpdate 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

Want help upgrading safely, with a staging test and rollback plan? See our ERPNext implementation and support service.

Vivek Choudhary
Hi, I'm Vivek Choudhary

I build websites, SEO, ERPNext systems and mobile apps for Indian businesses from Mumbai, including ERPWork, my free ERPNext app for Android. Articles are drafted with the help of AI tools, then checked and edited by me. If something here doesn't fit your situation, message me on WhatsApp and I'll reply personally.

Need help with this?

Get honest advice and a clear quote from our team. No obligation.