# Migration guides

🤓 Looking for the v3 to v4 migration guide?

The v3 to v4 migration guides are located in the v4 documentation (opens new window)

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 follow the Update Strapi guide.


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.


Upgrading from 3.2.5 to 3.6.9requires executing all of the guides in the listed order:

  1. Migration guide from 3.2.5 to 3.3.0.
  2. Migration guide from 3.3.x to 3.4.0.
  3. Migration guide from 3.4.x to 3.4.4.
  4. Update Strapi guide.

# v3 stable guides

# v3 early stage guides


The Strapi alpha ands beta versions are no longer supported, and users should upgrade to v3 stable or v4. If there are issues upgrading, it is generally recommended to create a new project.

v3 beta migration guides
v3 alpha migration guides