Updating WooCommerce isn’t like updating a small plugin. It can change templates your theme overrides, migrate data in the database and require updates to the extensions around your checkout. Done without a plan, a routine update can cost a day of sales.
Before the update
- Back up files and database. Orders, customers and settings live in the database.
- Read the changelog — especially for major versions — for template changes, raised requirements and deprecations.
- Check extension compatibility. Payment gateways, subscriptions, shipping and tax extensions usually state which WooCommerce versions they support.
- Check requirements such as the minimum WordPress and PHP versions. See which PHP version WordPress should use.
Test on staging first
For major releases, repeat the update on a staging copy with email stopped and gateways in test mode. Walk through the purchase flow there before touching the live store.
The update itself
- Choose a quiet time for the shop.
- Update extensions and WooCommerce in the order their changelogs suggest, not all at once.
- If WooCommerce asks for a database update, run it after confirming the backup.
- Clear caches, including any page or object cache, once updates are complete.
Checks straight afterwards
- WooCommerce → Status: look for outdated template overrides and new warnings.
- Test purchase with the gateway’s test mode or on staging: basket, shipping, coupon, payment, confirmation.
- Order admin: does the test order appear with the right status and totals?
- Emails: were the customer and admin emails generated?
- Error log: any new PHP warnings or errors?
# What's installed, and what has updates waiting
$ wp plugin list --status=active --fields=name,version,updateIf something goes wrong
Act quickly but carefully. If one extension caused the problem, roll back that plugin and keep the rest. A full restore is faster when many things broke — but it removes any orders placed since the backup, so note them before restoring.
Make it routine
The safest WooCommerce update is a small one, applied regularly with the same checks every time. That’s the approach in our WooCommerce maintenance checklist and in our Commerce plan, which includes WooCommerce care and a purchase-flow check wherever a safe test setup exists.
Frequently asked questions
How often does WooCommerce release updates?
WooCommerce releases updates regularly, with larger releases several times a year and smaller fix releases in between. Check the changelog before each update rather than relying on a fixed calendar.
Should I update WooCommerce extensions first or WooCommerce first?
Check each extension’s stated compatibility first. Often extensions release updates that support the new WooCommerce version before or alongside it; update in the order their changelogs recommend.
What if the checkout breaks after an update?
Put the shop into a safe state quickly: roll back the component that caused the problem or restore the pre-update backup, remembering that a full restore can remove orders placed since the backup.
Can I update WooCommerce on a live store?
Minor releases usually can be applied live with a backup and a checkout test afterwards. Major releases are safer to test on staging first.
