Migration guides

Migrations are necessary when upgrades to Strapi include breaking changes. The migration guides are sequential, meaning if there is more than 1 migration guide between your current version and the latest release, follow each guide in order.

If there is no specific migration guide between your current version and the latest release, you only need to follow the guide to upgrade Strapi.

✋ Caution

Plugins extension that create custom code or modify existing code will need to be updated and compared to the changes in the repository. Not updating the plugin extensions could break the application.

v4 migration guides

• Migration guide from 4.0.0+ to 4.0.6
• Migration guide from 4.0.6+ to 4.1.8
• Migration guide from 4.1.8+ to 4.1.10
• Migration guide from 4.2.x to 4.3.x
• Migration guide from 4.3.6 to 4.3.8
• Migration guide from 4.4.3 to 4.4.5
• Migration guide from 4.4.5 to 4.5.1
• Migration guide from 4.5.1 to 4.6.1
• Migration guide from 4.6.1 to 4.7.0
• Migration guide from 4.7.0 to 4.11.4
• Migration guide from 4.11.4 to 4.14.0

v3 to v4 migration guides

Migrating from v3.6.x to v4.0.x revolves around 3 topics:

• The code migration guide helps migrating the built-in back-end and front-end code of the Strapi application to v4.
• The data migration guide helps migrating the database content to v4.
• The plugin migration guide helps migrating a plugin to v4.

v3 migration guides

v3 migration guides are available in the v3 documentation.