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​

Rebuild the administration panel:

Rebuilding the application​

Run the following command in your project root directory:

yarn build

Start the application​

Start the application and ensure that everything is working as expected:

Restarting the application​

Run the following command in your project root directory:

yarn develop