What you’ll learn
  • how to upgrade Webiny from 5.38.x to 5.39.x

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

Step-by-Step Guide
anchor

1. Upgrade Webiny Packages
anchor

Upgrade all Webiny NPM packages by running the following command:

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

2. Run the Upgrade Command
anchor

The next step is to run the project upgrade:

3. Breaking Changes❗
anchor

3.1 Removed Deprecated APIs
anchor

As mentioned in the changelog, with this release, we’ve removed a couple of backend JavaScript APIs that were marked as deprecated in previous releases.

Essentially, we’ve removed a couple of older methods used for subscribing to lifecycle events and also for performing Headless CMS-related security permissions checks.

Before deploying, please refer to the separate Deprecated APIs article, and make sure to update your project code, if need be.

4. Deploy Your Project
anchor

Proceed by redeploying your Webiny project:

Make sure you deploy the entire system using the command shown above! You have to deploy all apps before using the system. Partial deploys will cause the upgrade to be applied incorrectly.
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.