{"id":14604,"date":"2026-10-18T21:10:33","date_gmt":"2026-10-18T19:10:33","guid":{"rendered":"https:\/\/mybox.com\/help\/?post_type=manual_kb&#038;p=14604"},"modified":"2026-10-18T21:10:37","modified_gmt":"2026-10-18T19:10:37","slug":"woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria","status":"publish","type":"manual_kb","link":"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/","title":{"rendered":"WooCommerce HPOS vs Legacy Order Storage: Compatibility, Performance, and Migration Criteria"},"content":{"rendered":"\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">WooCommerce HPOS and legacy order storage are two ways to store orders in WooCommerce. High-Performance Order Storage, or HPOS, uses a dedicated order storage system. Legacy order storage uses the WordPress post-based model.<\/p><div id=\"ez-toc-container\" class=\"ez-toc-v2_0_86 ez-toc-wrap-left counter-hierarchy ez-toc-counter ez-toc-custom ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Table of Contents<\/p>\n<span class=\"ez-toc-title-toggle\"><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 ' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#What_changes_with_HPOS\" >What changes with HPOS?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#HPOS_and_legacy_storage_compared\" >HPOS and legacy storage compared<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#Which_stores_are_the_best_candidates_for_HPOS\" >Which stores are the best candidates for HPOS?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#What_compatibility_checks_are_needed\" >What compatibility checks are needed?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#How_should_performance_and_reporting_be_assessed\" >How should performance and reporting be assessed?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#What_must_be_ready_before_migration\" >What must be ready before migration?<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-7\" href=\"https:\/\/mybox.com\/help\/en\/knowledgebase\/woocommerce-hpos-vs-legacy-order-storage-compatibility-performance-and-migration-criteria\/#When_is_delaying_migration_sensible\" >When is delaying migration sensible?<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_changes_with_HPOS\"><\/span>What changes with HPOS?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">HPOS changes where WooCommerce order data is stored and how connected tools access that data. Legacy order storage uses WordPress posts as the order data model. HPOS uses a dedicated order storage model instead.<\/p><\/div>\n\n<div id=\"mybox-2035490396\" class=\"mybox-content mybox-entity-placement\"><div class=\"early-access-banner-inpost\">\r\n  <div class=\"banner-left-inpost\">\r\n    <div class=\"icon-box-inpost\">\r\n      <img decoding=\"async\" src=\"https:\/\/mybox.com\/help\/wp-content\/uploads\/2026\/02\/square-info-icon.svg\" alt=\"Info\">\r\n    <\/div>\r\n    <div class=\"text-box-inpost\">\r\n      <span class=\"label-inpost\"><span class=\"translation-block translation-block-banner-text\">Early access<\/span><\/span>\r\n      <h4><span class=\"translation-block translation-block-banner-text\">Still need help?<\/span><\/h4>\r\n      <p><span class=\"translation-block translation-block-banner-text\">Contact our customer service team.<\/span><\/p>\r\n    <\/div>\r\n  <\/div>\r\n\r\n  <div class=\"banner-right-inpost\">\r\n    <a href=\"https:\/\/panel.mybox.com\/helpdesk2\/v\/list\/\" class=\"banner-button-inpost\"><span class=\"translation-block translation-block-banner-text\">Message us<\/span><\/a>\r\n  <\/div>\r\n<\/div><\/div>\n\n<div class=\"translation-block translation-block-merged\"><p class=\"wp-block-paragraph\">This distinction matters because an extension, report, or custom integration may expect orders to exist as WordPress posts. A store can therefore have a valid WooCommerce setup that still requires compatibility checks before changing its order storage method.<\/p><p class=\"wp-block-paragraph\">WooCommerce stores use orders to manage transactions and related store activity. Order storage is therefore connected to more than the checkout itself. It can also affect reporting, administration tools, integrations, and custom code that reads or updates order records. For broader context on how WooCommerce stores manage products and orders, see <a href=\"https:\/\/mybox.com\/help\/knowledgebase\/woocommerce-vs-prestashop-choosing-the-right-e-commerce-platform\/\">the mybox WooCommerce and PrestaShop comparison<\/a>.<\/p><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"HPOS_and_legacy_storage_compared\"><\/span>HPOS and legacy storage compared<span class=\"ez-toc-section-end\"><\/span><\/h2><figure class=\"wp-block-table\"><table>\n<thead><tr><th>Area<\/th><th>HPOS<\/th><th>Legacy order storage<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>Order data model<\/td><td>Uses the HPOS order storage model.<\/td><td>Uses WordPress post-based order storage.<\/td><\/tr>\n<tr><td>Extension compatibility<\/td><td>Requires extensions and integrations to support HPOS.<\/td><td>May suit tools built around the legacy post-based model.<\/td><\/tr>\n<tr><td>Performance focus<\/td><td>Designed for stores assessing order storage and database performance.<\/td><td>Uses the existing post-based order structure.<\/td><\/tr>\n<tr><td>Migration risk<\/td><td>Requires a compatibility review, testing, and a rollback plan.<\/td><td>Provides the current storage path for stores that are not ready to change.<\/td><\/tr>\n<\/tbody>\n<\/table><\/figure><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Which_stores_are_the_best_candidates_for_HPOS\"><\/span>Which stores are the best candidates for HPOS?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">HPOS is most suitable when the store has reviewed its extensions and integrations, has a clear need to assess order-related database performance, and can test the change before applying it to live order data.<\/p><ul class=\"wp-block-list\">\n<li><strong>Stores with a high order volume:<\/strong> order storage and database behaviour become more important as the store handles more order records and more order-related activity.<\/li>\n<li><strong>Stores with a controlled extension set:<\/strong> compatibility is easier to assess when the store knows which extensions, reports, and integrations access order data.<\/li>\n<li><strong>Stores with database or administration performance concerns:<\/strong> HPOS can be considered when order storage is part of the performance review.<\/li>\n<li><strong>Stores with a strong testing process:<\/strong> a staging test, review of reports and integrations, and a documented rollback plan reduce migration risk.<\/li>\n<\/ul><p class=\"wp-block-paragraph\">HPOS is not automatically the right choice for every store. A smaller store with few order records may gain little from changing storage if its current setup is stable and its extensions have not been checked.<\/p><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_compatibility_checks_are_needed\"><\/span>What compatibility checks are needed?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">Start with every component that reads, writes, exports, searches, or reports on WooCommerce orders. This includes extensions, reporting tools, payment or fulfilment integrations, custom code, and internal processes that depend on order records.<\/p><ol class=\"wp-block-list\">\n<li>List all extensions and integrations that use WooCommerce orders.<\/li>\n<li>Identify reports and exports that depend on order data.<\/li>\n<li>Check whether each component supports HPOS.<\/li>\n<li>Review custom code that expects orders to use the WordPress post-based model.<\/li>\n<li>Record any component that must remain on legacy storage until it is compatible.<\/li>\n<\/ol><p class=\"wp-block-paragraph\">Compatibility is not limited to whether checkout works. A store should also confirm that order administration, reporting, exports, and connected services continue to use the expected order data.<\/p><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"How_should_performance_and_reporting_be_assessed\"><\/span>How should performance and reporting be assessed?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">Performance should be assessed against the store&#8217;s own workload. Order volume, order searches, administration activity, reporting needs, and connected integrations all form part of the assessment. HPOS should be considered as a database and order-storage decision, not as a general replacement for wider site optimisation.<\/p><p class=\"wp-block-paragraph\">Reporting needs deserve a separate review. A report may still open while returning incomplete, delayed, or differently handled data if it depends on the legacy post-based structure. Compare important reports before and after testing, including order counts, totals, filters, exports, and date ranges used by the business.<\/p><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"What_must_be_ready_before_migration\"><\/span>What must be ready before migration?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">A migration should begin only after compatibility has been reviewed and the store has a safe testing path. The store should have:<\/p><ul class=\"wp-block-list\">\n<li>a complete list of extensions and integrations that use order data;<\/li>\n<li>confirmation that critical components support HPOS;<\/li>\n<li>test cases for checkout, order management, reporting, exports, and connected services;<\/li>\n<li>a comparison of important reports before and after the change;<\/li>\n<li>a tested rollback plan;<\/li>\n<li>a suitable time to monitor the store after the change.<\/li>\n<\/ul><p class=\"wp-block-paragraph\">Testing should use realistic orders and the reports the store depends on. A successful test is more than a working checkout. It should also confirm that order records, administration tasks, reports, exports, and integrations behave as expected.<\/p><h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"When_is_delaying_migration_sensible\"><\/span>When is delaying migration sensible?<span class=\"ez-toc-section-end\"><\/span><\/h2><p class=\"wp-block-paragraph\">Delaying migration is sensible when a critical extension or integration does not support HPOS, when reporting results have not been compared, or when the store cannot test and reverse the change safely. It is also reasonable to delay when the current legacy setup is stable and there is no clear order-storage or database reason to change it.<\/p><p class=\"wp-block-paragraph\">Use HPOS when its benefits match the store&#8217;s workload and the surrounding tools are ready. Keep legacy order storage while compatibility, reporting accuracy, testing, or rollback readiness remains unresolved. This decision gives store owners a practical way to balance performance goals with operational continuity.<\/p><\/div>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"template":"","format":"standard","manualknowledgebasecat":[25,11416,11411,36,11408],"manual_kb_tag":[198,4831,7437,12005,12006,12007,12008],"class_list":["post-14604","manual_kb","type-manual_kb","status-publish","format-standard","hentry","manualknowledgebasecat-hosting","manualknowledgebasecat-prestashop","manualknowledgebasecat-plugins","manualknowledgebasecat-migration","manualknowledgebasecat-wordpress","manual_kb_tag-woocommerce","manual_kb_tag-database-performance","manual_kb_tag-woocommerce-compatibility","manual_kb_tag-hpos","manual_kb_tag-order-storage","manual_kb_tag-legacy-order-storage","manual_kb_tag-migration"],"_links":{"self":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/14604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb"}],"about":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/types\/manual_kb"}],"author":[{"embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":3,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/14604\/revisions"}],"predecessor-version":[{"id":14621,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb\/14604\/revisions\/14621"}],"wp:attachment":[{"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/media?parent=14604"}],"wp:term":[{"taxonomy":"manualknowledgebasecat","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manualknowledgebasecat?post=14604"},{"taxonomy":"manual_kb_tag","embeddable":true,"href":"https:\/\/mybox.com\/help\/en\/wp-json\/wp\/v2\/manual_kb_tag?post=14604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}