What you’ll learn
  • how to upgrade Webiny from 5.32.0 to 5.33.0

Make sure to check out the 5.33.0 changelog to get familiar with the changes introduced in this release.

1. Upgrade Webiny Packages

Upgrade all @webiny/* packages by running the following command:

yarn up "@webiny/*@5.33.0"

Once the upgrade has finished, running the yarn webiny --version command in your terminal should return 5.33.0.

2. Upgrading CMS Models via Code Definitions

If you do not have CMS Models defined via code (via CmsModelPlugin), you can skip this step.

Since we introduced a new property, storageId, into CMS Model Field definition, you must add it to your existing CMS Model Field definitions. This is only for the CMS models which are created prior to the 5.33.0. Please read the Upgrading CMS Model Plugin Definitions of this article.

3. Deploy Your Project

Proceed by redeploying your Webiny project:

# Execute in your project root.
yarn webiny deploy --env {environment}

Make sure you deploy the entire system using the command shown above! You have to deploy all apps before using the system. Partial deploys may cause the upgrade to be applied incorrectly.

4. Upgrade in the Admin Area

There is a database upgrade that we execute from the Admin Area. To make sure it starts, clear your browser cache and log in.

When upgrade screen shows, just follow the instructions.

Note that upgrade is done across all the models you have in all tenants and all locales.

As stated in the Upgrade Webiny section, we recommend that you first deploy your changes into one of your pre-production environments, like dev or staging.

Learn more about different deployment environments in the CI/CD / Environments key topic.