We recently updated the major version of
pnpm to version 8+. Developers will need to update pnpm in their environments in order to build WooCommerce.
Due to instability in early versions of pnpm 8, we had decided to stay on pnpm 7 until all issues were resolved. Now that pnpm 8 is stable, we have upgraded it in WooCommerce Core. This allows us to get features and bug fixes only available in pnpm 8. Since pnpm 8 is a major version upgrade, you’ll need to upgrade it in your environment to continue working on the WooCommerce repo.
How can I tell if this affects me?
This affects everyone building on the WooCommerce repo. This change was merged on April 25th, so if you have recently pulled, you will need to upgrade. You’ll be informed by pnpm in your environment if it affects you. It will instruct you to upgrade to pnpm 8.
What action should I take?
In order to update your pnpm version, run
pnpm i -g pnpm. You can confirm that you’ve upgraded in your environment by running
pnpm -v to check the version (it should be greater than version 8).
Once you’ve upgraded, you can reinstall dependencies by running
pnpm install. If you have a PR with dependency changes, we also recommend removing the
pnpm-lock.yaml and regenerating it with
That’s it! Feel free to reach out to us in the comments or in the WooCommerce Community Slack.