I’m excited to announce the release of HPOS Compatibility Scanner, a free WordPress® plugin designed to help developers identify and fix compatibility issues with WooCommerce’s High-Performance Order Storage (HPOS).
This plugin aims to fill a gap that has been glaringly obvious since HPOS became the new standard.

Why This Plugin?
When WooCommerce introduced HPOS over a year ago, it promised faster performance and a modernized architecture.
But for developers, it also brought a wave of changes that required reworking how we handle orders in our plugins.
Despite this, many developers (myself included) haven’t fully updated our plugins.
Why?
Because WooCommerce’s built-in notification system simply says that a plugin is “incompatible” and should be deactivated.
That’s it. No details, no actionable steps.

For a feature as impactful as HPOS, this lack of clarity is frustrating – and it’s left many in the WooCommerce® community scrambling to diagnose compatibility issues.
What Does HPOS Compatibility Scanner Do?
HPOS Compatibility Scanner changes that.
This plugin doesn’t just tell you your plugin is incompatible – it shows you why. It scans the codebase of any selected plugin, flagging the use of outdated or incompatible APIs and direct database calls that could break under HPOS.
It’s an actionable, developer focused solution designed to:
- Identify specific issues in your code.
- Provide detailed scan results in an easy-to-read table.
- Export results as a CSV for further analysis.

Why Should WooCommerce® Have Built This?
Let’s be honest; this is a tool WooCommerce® should have provided from the start.
Transitioning an entire ecosystem to a new architecture is no small feat, and developers deserve better tools to manage this shift.
HPOS Compatibility Scanner exists because the WooCommerce® community needed it, and I’m proud to contribute a solution.
How to Use HPOS Compatibility Scanner
The plugin integrates seamlessly with the WordPress® admin interface. Here’s how to get started:
- Navigate to
HPOS Scanner
in your admin dashboard. - Select a plugin to scan from the dropdown menu.
- Click Scan Plugin to get detailed results on compatibility issues.
You can even export the results as a CSV for collaborative debugging with your team.
What’s Next?
This is just the beginning.
Future updates will include real-time notifications, expanded API coverage, and advanced filtering options for the scan results.
I’m always looking for ways to improve the tool, so feedback from the community is highly appreciated 🙏

Get Involved
I built this plugin to solve a pain point that I’ve felt personally, and I’m sure I’m not alone.
If you’re a developer struggling with the HPOS transition, give this tool a try. It’s free, open-source, and available now on GitHub.
Let me know how it works for you and what features you’d like to see in the future (if any) 🤘
Leave a Reply