Versions
Frappe and ERPNext follow yearly major versions. Knowing where you are helps when reading docs and installing apps.
Major versions
| Version | Status (early 2026) | Notes |
|---|---|---|
| v15 | Stable | Most production sites. LTS-style maintenance. |
| v16 | Active development | Latest features, breaking changes still landing |
| v14 | Legacy | Out-of-support; upgrade recommended |
The version your site is running:
bench version
Branch names
| Git branch | What |
|---|---|
develop |
Bleeding edge — new features land here first. Don't run on production. |
version-15 |
Current stable |
version-14 |
Previous stable, security patches only |
When installing an app, you should match its branch to your Frappe version: bench get-app erpnext --branch version-15.
App compatibility
Each Frappe app declares which Frappe versions it supports. Before installing on production:
- Check the app's README or
pyproject.toml - Confirm your
bench version - Read the app's release notes for breaking changes
Upgrades
Major version upgrades involve schema migrations and potentially custom-code review. On Frappe Cloud / Prilk-managed plans, we coordinate the upgrade with you. On self-hosted, follow the official upgrade guide carefully and back up before starting.
Last updated 3 days ago
Was this helpful?