Skip to main content

Upgrade Strapi version

Strapi periodically releases code improvements through upgrades. Upgrades contain no breaking changes and are announced in both the terminal and in the administration panel. Migration guides are provided whenever a new Strapi version includes breaking changes.

✋ 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.

Upgrade the dependencies​

☑️ Prerequisites
  • Stop the server before starting the upgrade.
  • Confirm there are no migrations between the current and ultimate Strapi versions.

  1. Upgrade all of the Strapi packages version numbers in package.json to the latest stable Strapi version (Strapi stable versions are listed on the GitHub releases page):

    // path: package.json

    {
      // ...
      "dependencies": {
        "@strapi/strapi": "4.7.0", 
        "@strapi/plugin-users-permissions": "4.7.0",
        "@strapi/plugin-i18n": "4.7.0",
        "better-sqlite3": "7.4.6"
        // ...
      }
    }

  2. Save the edited package.json file.

  3. Install the upgraded version:

    yarn
    💡 Tip

    If the operation doesn't work, try removing your yarn.lock or package-lock.json. If that doesn't help, remove the node_modules folder as well and try again.

Rebuild the application​

Run the following command in your project root directory to rebuild Strapi's admin panel:

yarn build

Restart the application​

Run the following command in your project root directory to restart the application:

yarn develop