WooCommerce 10.6 released
brings block UX refinements, database and query optimisations, and targeted developer advisories for stores running at scale.
WooCommerce 10.6.0 is now the current stable tag, and the release remains backwards compatible. The release includes a database update, so plan the upgrade window accordingly and confirm backups before deploying to production.
For the complete feature narrative and context, read WooCommerce 10.6: Enhanced blocks and a faster dashboard.
Product Collections: faster set-up, clearer intent
Handpicked Products now starts with the product picker
When adding a Handpicked Products collection, the flow now begins at the product picker. This reduces misconfiguration and shortens the path from “add collection” to “publish page”, particularly for merchandising teams building seasonal or campaign landing pages.
Products by Brand begins with a brand-first journey
Products by Brand has been added as a collection option, and the initial configuration starts with a dedicated brand picker. This makes brand-led browsing pages quicker to assemble and easier to review during QA.
Category and tag collections begin with taxonomy selection
Products by Tag and Products by Category now begin with a taxonomy picker, aligning the editor experience with the decision merchants actually make first: which taxonomy to feature, then how to fine-tune the output.
Cart and Checkout Blocks: tighter layout, clearer affordances
Remove action moved to the right, now using a trash icon
The remove control has been repositioned to the right of the quantity picker and expressed as an icon rather than text. This improves scanability and reduces layout noise in dense carts, especially on mobile where horizontal space is limited.
Sale and savings presentation updated
Sale badge placement has been adjusted alongside individual prices in cart, with spacing and font sizes tuned for more compact product meta information. The savings badge design has also been refined to better communicate price reductions without dominating the row.
Performance: fewer queries and less admin friction
WooCommerce 10.6 continues the push towards database efficiency. Checkout and admin screens execute fewer SQL queries through smarter caching strategies and deferred cleanup tasks, helping stores with larger catalogues and order histories remain responsive.
The Recent Reviews widget now loads asynchronously to avoid admin lockouts caused by expensive queries. Product pages also benefit from consolidated cache management that reduces redundant queries when rendering related and upsell products.
Order admin month filtering has also been optimised by improving how date ranges are fetched, which can reduce load on high-volume stores that depend on the orders list for daily operations.
New merchant-facing controls and compliance hooks
Product Filters: taxonomy ordering can respect menu order
Product Filters blocks can now order taxonomy terms by menu_order, allowing categories and brands to reflect the drag-and-drop ordering set in WordPress admin. This is useful when filter order is part of merchandising strategy rather than alphabetical discovery.
Tax calculations: tax-inclusive shipping price filter
A new filter supports tax-inclusive shipping pricing for stores that need fixed shipping costs to remain constant regardless of VAT rate. This is often required for consumer protection compliance in parts of Europe, where displayed totals must not fluctuate based on VAT in a way that misleads the shopper.
For implementations that always need tax-inclusive shipping pricing, the filter can be set to always return true.
add_filter( 'woocommerce_shipping_prices_include_tax', '__return_true' );
API updates: expanded experimental REST caching
Experimental REST API caching continues to broaden. WooCommerce 10.6 adds caching for taxes, currencies, countries, and continents endpoints, alongside additional validation. For headless builds and integrations that repeatedly request static reference data, this can lower latency and reduce repetitive processing.
Developer advisories to review before deploying
Product images are now lazy-loaded by default in Product Image block
Lazy loading is enabled by default, which can improve perceived performance on product pages and collection layouts. If your theme or performance tooling requires custom behaviour, the new woocommerce_product_image_loading_attr filter can be used to adjust the loading attribute.
woocommerce_get_breadcrumb second parameter may be null
Integration with the WordPress Core Breadcrumbs block means the second parameter passed to woocommerce_get_breadcrumb can be null. Any custom code hooking into this filter should add a null check to avoid type errors.
Store API: per_page restriction for Products and ProductReview
Store API endpoints now enforce a minimum per_page value of 1. Integrations that used per_page=0 as a “return all” shortcut will need to switch to pagination to remain compatible.
Database update included
This release includes a database update, including the update routine wc_update_1060_add_woo_idx_comment_approved_type_index. Treat this as an operational change: run the upgrade in staging first, verify any custom reporting queries, and confirm background updates complete successfully.
FAQ
What is the WooCommerce 10.6 release date?
WooCommerce 10.6.0 was released on .
Does WooCommerce 10.6 include a database update?
Yes. WooCommerce 10.6 includes a database update, including the routine wc_update_1060_add_woo_idx_comment_approved_type_index. Schedule the upgrade to allow time for the update and verify completion.
What changed in Product Collections in WooCommerce 10.6?
Product Collections now start configuration with the most relevant picker: Handpicked Products begins with product selection, Products by Brand begins with a brand picker, and tag/category collections begin with taxonomy selection.
What changed in Cart and Checkout Blocks in WooCommerce 10.6?
The remove action now uses a trash icon and is positioned to the right of the quantity picker. Cart presentation has also been refined with improved spacing, typography, and updated sale and savings badge design.
How does WooCommerce 10.6 improve performance?
WooCommerce 10.6 reduces SQL queries on checkout, product pages, and admin screens via improved caching and query optimisation. The Recent Reviews widget now loads asynchronously, and related/upsell rendering executes fewer redundant queries.
What is the new WooCommerce 10.6 filter for tax-inclusive shipping prices?
The filter is woocommerce_shipping_prices_include_tax. Setting it to true allows shipping prices to be treated as tax-inclusive for compliance needs.
Where can I read the official WooCommerce 10.6 announcement?
The official developer post is WooCommerce 10.6: Enhanced blocks and a faster dashboard.
