Updates and Migrations
Strapi periodically releases code improvements through new versions. New Strapi versions are announced in both the terminal and in the administration panel, and GitHub release notes list what is new with each new version.
Whenever a new Strapi version is available, there are 2 possible cases:
| Does the new Strapi version include breaking changes? | The process is a/an… | You should read the… |
|---|---|---|
| No | Update | Generic update guide |
| Yes | Migration | Specific migration guides (see below) |
There are 2 types of migrations:
- migrating from a minor version to another minor version (e.g., from v5.x to v5.y)
- migrating from a major version to another major version (e.g., from v4.x to v5.0)
Depending on your use case, click on any of the following cards to read detailed instructions to update or migrate:
⟳ Updates
Read a generic update guide. Useful when there is no breaking change.
⬆️ v5.x migration guides
Read specific guides to handle breaking changes while migrating from Strapi v5.x to Strapi v5.y.
⤴️ v4 to v5 migration guides
Read specific guides to handle breaking changes while migrating from Strapi v4 to Strapi v5.