Black FridayCyber Monday 2026
14Days
14Hrs
52Mins
26Secs
Flat20% OFF

Our biggest sale of the year20% off the first payment on all maintenance plans. Code BF2026

Grab the deal
WooCommerce

WooCommerce HPOS: What High-Performance Order Storage Is and How to Enable It Safely

WooCommerce can store orders in dedicated tables instead of the posts table. Learn what HPOS is, when it is on by default and how to enable it safely.

wpallsolution 6 min read

WooCommerce HPOS stands for High-Performance Order Storage. It changes where WooCommerce keeps order data: in dedicated tables built for orders instead of in the general WordPress posts tables. New stores use it by default, while older stores can still run on the old storage until their owners choose to move. This guide explains what changes, how to check what your store uses, and how to enable HPOS in a careful order.

Quick answer

According to the WooCommerce documentation, HPOS is enabled by default for new installations from WooCommerce 8.2 onward, and existing stores are not migrated automatically. To enable it, go to WooCommerce → Settings → Advanced → Features, turn on compatibility mode so orders are synchronised between the two storage types, let the background sync finish, then select High-performance order storage. Before you do this, back up, check extension compatibility and test on a staging copy.

How this guide was prepared: it is research-based. We used the official WooCommerce documentation listed under Sources, checked on October 23, 2026. We did not change the storage of a live store for this article. Menu names can differ slightly by version, so follow the screen in your own store.

What HPOS changes

Historically WooCommerce stored orders as a special post type in the WordPress posts and post meta tables, which are shared with all other content. HPOS (formerly called Custom Order Tables) stores order data in dedicated tables for orders, addresses, operational data and order meta, which the documentation describes as optimised for WooCommerce queries. In daily use, you still manage orders under WooCommerce → Orders. The change is under the surface, but extensions and custom code that read orders directly from the posts tables need to support the new storage.

The decision tree: should you enable HPOS now?

Flowchart for enabling WooCommerce HPOS: five questions about store age, storage type, extension compatibility, backups and a test order
Five questions show whether it is safe to enable HPOS now.
  1. New store from WooCommerce 8.2 or later? HPOS is already the default (Step 1).
  2. Older store on posts storage? Plan the move; it is not automatic (Step 2).
  3. Incompatible extensions listed? Update or replace them first (Step 3).
  4. No tested backup or staging copy? Make them first (Step 4).
  5. Test order failed? Revert and investigate (Step 5).

6 steps to enable HPOS safely

Step 1: Find out what your store uses now

Open WooCommerce → Settings → Advanced → Features and look at the order data storage setting. If High-performance order storage is already selected, you are done; check that compatibility mode is off or on as you intend. If WordPress posts storage is selected, your store still uses the older method.

Step 2: Take a backup and test on staging

Back up the database and files, and try the change on a copy of the store first. If you are unsure that your backups would restore, read is your WordPress backup really safe. The general routine for store updates is in our WooCommerce maintenance checklist.

Step 3: Check extension compatibility

If an incompatible extension is active, WooCommerce disables the HPOS option under order data storage. Use View and manage to see which extensions are flagged, or open the plugin list filtered for plugins incompatible with the feature. Update them, replace them or ask the developer to add HPOS support. The documentation also advises keeping extensions that use custom post types, such as subscriptions and bookings, active during migration so data stays consistent.

Step 4: Turn on compatibility mode and let orders sync

Tick Enable compatibility mode (synchronizes orders to the posts table). WooCommerce then copies orders between the two storage types through background actions, 25 at a time, and you can run them manually from WooCommerce → Status → Scheduled Actions. Wait until the sync has finished. On a large store this can take a while, so do it at a quiet time.

Step 5: Select high-performance order storage

When both storages are in sync, select High-performance order storage (recommended) and save. Keeping compatibility mode on for a while lets you go back easily, because with compatibility mode on you can switch back to posts storage if problems appear.

Step 6: Test orders, emails and extensions

Place a test order, check that it appears in WooCommerce → Orders, test a refund, a coupon, order emails and any extension that touches orders. If checkout misbehaves, see WooCommerce checkout not working, and if orders do not appear after payment, see WooCommerce orders missing after payment. If something is wrong, switch back to posts storage and investigate on staging.

Version and hosting differences

  • HPOS was introduced earlier as a feature, and became the default for new installs from WooCommerce 8.2, so older versions have different screens.
  • Custom code that reads orders directly from the posts tables should use WooCommerce’s order functions; ask your developer to check it.
  • Large stores may need more time for the sync; ask your host if background tasks are limited.

How to verify the change

  • The Features screen shows high-performance order storage selected.
  • A new order appears in WooCommerce → Orders and in your emails.
  • No scheduled actions are failing under Status → Scheduled Actions.
  • Reports and integrations that use orders still work.

How to avoid problems

  • Do not change order storage in the middle of a busy sales period.
  • Do not remove compatibility mode until you have tested your extensions and integrations.
  • Keep a note of the date and settings you changed.

Frequently asked questions

Is HPOS required?

It is the default for new stores, but older stores can stay on posts storage until they choose to move. Check the WooCommerce documentation for your version.

Will HPOS change how I manage orders?

Not in daily use. You still use WooCommerce → Orders; the storage underneath is different.

Can I go back to the old storage?

The documentation says you can revert to posts storage if compatibility mode is on, which is why it is worth keeping it on at first.

Why is the HPOS option greyed out?

An active extension may be flagged as incompatible. Use View and manage to see which one.

Related guide: WooCommerce Product Variations Not Working? Fix Dropdowns and Prices

What to do next

Check your current setting, back up, review extensions and test on a copy. If your store needs help with the move, wpallsolution offers a WooCommerce checkout service and WordPress maintenance packages. We cannot promise outcomes without seeing your store.

Sources and official documentation

Keep reading

More guides

Need a hand with this?

Tell us what is happening. We reply with honest next steps.

Talk to us