| title | Migration Guides |
|---|---|
| label | Overview |
| order | 10 |
| desc | Guides for upgrading Payload projects across major versions. |
| keywords | migration, upgrade, breaking changes, documentation, Content Management System, cms, headless, javascript, node, react |
Payload follows semantic versioning. Major version bumps may include breaking changes; the guides below walk through each upgrade path.
- 3.0 to 4.0 Migration Guide — upgrade Payload 3.x projects to 4.0.
- 2.0 to 3.0 Migration Guide — upgrade Payload 2.x projects to 3.0.