Skip to main content
HPOS compatible

WooCommerce HPOS Delivery Integration

FleetConnector fully supports WooCommerce High-Performance Order Storage (HPOS). Automate delivery dispatch to Onfleet with the latest WooCommerce architecture.

What is WooCommerce HPOS?

High-Performance Order Storage (HPOS) is WooCommerce's modernized order data architecture. Instead of storing orders as WordPress "posts" in the wp_posts and wp_postmeta tables, HPOS uses dedicated custom tables optimized for order data.

Better performance

Faster queries for stores with thousands of orders

Improved scalability

Handle higher order volumes without database slowdowns

Future-proof

HPOS is becoming the default and will eventually be required

HPOS Timeline

WooCommerce 8.2+

HPOS available as opt-in feature

WooCommerce 9.0+

HPOS enabled by default for new installations

Future versions

Legacy storage will be deprecated

Why delivery automation can break with HPOS

Not all WooCommerce plugins are HPOS-compatible. Here's what can go wrong.

Direct database queries

Plugins that query wp_postmeta directly instead of using WooCommerce APIs won't find order data after HPOS migration.

get_post_meta() for orders

Using WordPress post functions to access order meta fields fails because orders are no longer posts.

WP_Query for orders

Standard WordPress queries for "shop_order" posts won't return results with HPOS enabled.

Outdated hooks

Some order-related action hooks have changed. Plugins relying on deprecated hooks may miss order events.

The result: Orders are placed but never sent to your delivery system. Drivers don't receive tasks. Deliveries are delayed or missed.

FleetConnector 2.1.0 HPOS Features

  • Uses WooCommerce data abstraction layer (wc_get_order, order CRUD)
  • Declares HPOS compatibility in plugin headers
  • Works with legacy storage, HPOS, and compatibility mode
  • No reconfiguration needed after HPOS migration
  • Tested with WooCommerce 8.x and 9.x

FleetConnector 2.1.0: Full HPOS support

FleetConnector was rebuilt for HPOS from the ground up. We use WooCommerce's official data abstraction layer, meaning the plugin automatically works regardless of which storage mode you use.

Whether you're running legacy storage, HPOS, or compatibility mode (both active during migration), FleetConnector continues to dispatch orders to Onfleet without interruption.

Read the full release announcement

HPOS migration checklist

Follow these steps to safely migrate to HPOS while keeping your delivery automation running.

1

Update FleetConnector to 2.1.0+

Go to Plugins → Updates in WordPress. Ensure FleetConnector shows version 2.1.0 or higher. Update if needed.

2

Check other plugin compatibility

Go to WooCommerce → Settings → Advanced → Features. View the HPOS compatibility report for all installed plugins.

3

Backup your database

Create a full database backup before enabling HPOS. Most hosting providers offer one-click backup options.

4

Enable HPOS with compatibility mode

In WooCommerce → Settings → Advanced → Features, enable HPOS but keep "Enable compatibility mode" checked initially.

5

Test order dispatch

Place a test order and verify it syncs to Onfleet correctly. Check the FleetConnector dashboard for any errors.

6

Run data migration

If WooCommerce prompts to migrate historical orders, run the migration. This happens in batches and can run in the background.

7

Disable compatibility mode (optional)

Once all plugins are confirmed working and migration is complete, you can disable compatibility mode to get full performance benefits.

Frequently asked questions

HPOS (High-Performance Order Storage) is WooCommerce's new order data architecture that stores orders in custom database tables instead of WordPress post meta. It improves performance for stores with large order volumes and is becoming the default in WooCommerce.

Yes. FleetConnector 2.1.0 and later fully supports WooCommerce HPOS. The plugin works seamlessly with both legacy (post-based) and HPOS storage modes, including compatibility mode where both are active.

Plugins that directly query wp_postmeta for order data instead of using WooCommerce's order APIs will fail with HPOS because orders are no longer stored as posts. Properly built plugins use WooCommerce's data abstraction layer and work with either storage method.

No. FleetConnector settings and configurations remain intact when you switch to HPOS. The plugin automatically uses the correct data access methods based on your WooCommerce configuration.

Yes. HPOS compatibility mode (where WooCommerce syncs data to both storage systems) works perfectly with FleetConnector. This is the recommended approach during migration.

FleetConnector 2.1.0 or later is required for HPOS support. If you're running an earlier version, update through WordPress Plugins before enabling HPOS in WooCommerce.

Go to Plugins in your WordPress admin and check the version number next to FleetConnector. Version 2.1.0 or higher includes full HPOS support. You can also check the plugin's settings page for version information.

No. Existing Onfleet tasks are stored in Onfleet's system, not in WooCommerce. The HPOS migration only affects how WooCommerce stores order data locally. Your dispatch history and task records remain unchanged.

WooCommerce recommends migrating to HPOS for better performance, especially for stores processing many orders. HPOS will become the default and eventually the only option. If all your plugins are compatible, migrating is recommended.

The migration time depends on your order volume. WooCommerce migrates orders in batches. For most stores, migration completes within minutes to a few hours. FleetConnector continues working throughout the migration process.

Ready for HPOS?

Get FleetConnector 2.1.0 and automate your delivery dispatch with full HPOS compatibility.