# Migration Guides

Source: https://payloadcms.com/docs/beta/migration-guide/overview

# Migration Guides

Payload follows [semantic versioning](https://semver.org/). Major version bumps may include breaking changes; the guides below walk through each upgrade path. See the [versioning policy](/docs/v4/migration-guide/versioning.md) for what counts as a breaking change.

- [3.0 to 4.0 Migration Guide](/docs/v4/migration-guide/v4.md) — upgrade Payload 3.x projects to 4.0.
- [2.0 to 3.0 Migration Guide](/docs/v4/migration-guide/v3.md) — upgrade Payload 2.x projects to 3.0.