Warning
You're browsing the documentation for an old version of Webiny. Consider upgrading your project to Webiny 5.35.x.
What you’ll learn
  • how to upgrade Webiny from 5.34.x to 5.35.0
Make sure to check out the 5.35.0 changelog to get familiar with the changes introduced in this release.

1. Upgrade Webiny Packages
anchor

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

yarn up "@webiny/*@5.35.0"

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

2. Run the Upgrade Command
anchor

The next step is to run the project upgrade:

yarn webiny upgrade
This script will create backups of some files, so make sure you review the changes, and manually apply any changes you might have in those files to the new files.
If the upgrade command ends in error "Script does not exist.", please clear your npx cache. You can run npx clear-npx-cache to clear it, or just delete it manually from your npx directory.

3. Upgrade Your Code to the New Lambda Function Setup
anchor

In the 5.35.0 we are removing the Headless CMS Lambda function from the deployment. This is a breaking change, but it should not take you a long time to fix.

Please read the Removing the Headless CMS Lambda Function article to learn how to upgrade your code to the new Lambda function setup.

4. Deploy Your Project
anchor

Proceed by redeploying your Webiny project:

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

Once deployed, access your Admin app to finalize the Page Builder upgrade, which will migrate your existing page blocks to the new Block Manager.

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.

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.