What you’ll learn
  • how to upgrade Webiny from 5.33.0 to 5.34.0
Make sure to check out the 5.34.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.34.0"

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

2. Run the Upgrade Command

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. Deploy Your Project

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.

4. Final Words

Due to the vast amount of potential customizations in the user land, it is impossible to create a 100% reliable upgrade process to satisfy everyone. If you run into any build issues, Typescript errors, etc., don’t hesitate to reach out on our Slack Community external link with details of your issue (post text, screenshots, whatever you have), and we’ll help you out with your upgrade.