Why Did a WooCommerce Core Update Break My Subscriptions?
Why This Happens
WooCommerce core and WooCommerce Subscriptions are separate plugins with their own release schedules, and Subscriptions has to explicitly add compatibility for major core changes rather than automatically inheriting it. Areas under the most active development — High-Performance Order Storage and the block-based checkout among them — are exactly where a core update can introduce a change that an older Subscriptions version doesn't yet account for correctly.
Common Causes
- WooCommerce core updated automatically while WooCommerce Subscriptions wasn't updated at the same time, leaving a version combination that was never actually tested together.
- A core update changing internal hooks or data structures that Subscriptions (or a third-party extension built on top of Subscriptions) depended on in a way that wasn't part of WooCommerce's stable, documented API.
- HPOS-related changes specifically, if the store recently enabled (or a core update changed defaults around) High-Performance Order Storage without every extension in use being confirmed compatible.
- A theme or another plugin that itself hasn't kept pace with a core update, producing a conflict that looks like a subscriptions-specific issue but is actually broader.
How to Handle Updates Safely Going Forward
- Check both plugins' changelogs for the specific versions involved before assuming the cause — a known, documented compatibility issue is often already flagged there.
- Update WooCommerce core and WooCommerce Subscriptions together, not independently, and always on a staging copy first for a store with active subscriptions.
- Disable automatic core updates on a subscriptions-dependent store if updates aren't being tested before they land, in favor of a deliberate, staged update process.
- If already broken, check the specific error (PHP error log, a failed renewal's order notes) against known issues for the exact version combination in use before attempting a fix blind.
See WooCommerce fixes for diagnosing and resolving a core-update compatibility break properly.