1.7 KiB
1.7 KiB
| title | aliases | tags | sources | created | updated | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Migration Guides — Overview |
|
|
|
2026-05-15 | 2026-05-15 |
Migration Guides — Overview
Payload follows semantic versioning. Major version bumps may include breaking changes; each upgrade path has a dedicated migration guide.
Upgrade Paths
| From | To | Guide |
|---|---|---|
| Payload 2.x | 3.0 | wiki/payloadcms/migration-troubleshooting — v2→v3 section |
| Payload 3.x | 4.0 | wiki/payloadcms/migration-troubleshooting — v3→v4 section |
Key Takeaways
- Payload uses semantic versioning — minor/patch releases are safe to upgrade; only major bumps may break.
- Always read the migration guide for the specific major version before upgrading.
- Two active upgrade paths exist: 2→3 and 3→4.
- See wiki/payloadcms/database-migrations for running DB schema migrations after a Payload upgrade.
- See wiki/payloadcms/installation for version requirements (Node 24+, Next.js 16.2.6+).
Related
- wiki/payloadcms/migration-troubleshooting — full codemod steps, dependency dedup fix, common errors
- wiki/payloadcms/database-migrations —
migrate,migrate:create,migrate:rollbackCLI reference - wiki/payloadcms/getting-started — fresh install baseline
Source: raw/migration-guide__overview.md — https://payloadcms.com/docs/migration-guide/overview