Upgrades
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.
The latest version number of Strapi that was released by the Strapi core team can be found on npm or on GitHub.
When a new version of Strapi is released, you might want to upgrade, and the present page serves as an entry point for information about upgrading.
How can I find my current Strapi version number?
You can find the current version number of your Strapi application:
either in the admin panel, by going to Settings > Global Settings > Overview and looking at the Strapi version number printed in the Details section:
or by running
yarn strapi version
ornpm run strapi version
in the terminal, from the folder where your Strapi project is located.
It is strongly advised not to upgrade a critical or production-ready project from Strapi v4 to Strapi 5.
The content of migration resources might not be final yet. Migration resources are currently only provided to prepare you for the upgrade to Strapi 5 when it is released as a stable version.
Strapi 5 is currently only provided as a Release Candidate (RC) version and is not meant to be used in production yet.
Click on one of the 2 following cards depending on your use case:
4️⃣ I'm running Strapi v4 and want to upgrade to Strapi 5.
All you need to know to upgrade to Strapi 5, the latest major version of Strapi.
5️⃣ I'm already running Strapi 5 and want to upgrade to the latest version.
All you need to know to use the automatic upgrade tool, which upgrades both from Strapi v4 to Strapi 5 or to an existing Strapi 5.x.x version to a more recent one.