Migrating from Strapi v4 to Strapi 5

The latest major version of Strapi is Strapi 5. The upgrade tool and its codemods should automate some parts of the migration from v4 to Strapi 5. Additional information is also given below about breaking changes and dedicated migration resources for specific topics.

❗️ Warning

It is currently strongly advised that you refrain from migrating from Strapi v4 to Strapi 5, especially in a production environment.

The beta version of Strapi 5 is not meant to be used in production yet.

📄️ Use the upgrade tool

Learn how you can use the CLI upgrade tool to migrate from v4 to Strapi 5.

📄️ Breaking changes list

Read more about the differences between Strapi v4 and v5 and the resulting breaking changes.

📄️ Specific migration resources

Handle specific use cases: Plugins migration, helper-plugin deprecation, Entity Service API deprecation.