Migration Guides

May 4, 2026 · View on GitHub

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.