WooCommerce 10.2 has been released on September 16, 2025. This post highlights what’s new in this version of WooCommerce.
See our update guide.
Download directly from WordPress.org.
Other important information:
- 📀 This release does include a database update.
- See more
What’s coming in 10.2
Product Collection Carousel
The Product Collection block continues to expand its offerings. This version introduces a new carousel layout for the Product Collection block, allowing stores to display products in an interactive, scrollable view, ready for all screen sizes.
The block allows you to style the arrows to match a store’s design, as well as adjust their default position, giving you full control over how the carousel looks and feels.
If you want to know more about this and other features in the Product and Category Collection blocks, join our upcoming Office Hours next week!
Introducing the Product Collection block for Cross-Sells
[#60278]
As part of improving the Cart block, we’ve also replaced the Cart Cross-Sells block with the Product Collection block’s Cross-Sells collection. The new block offers enhanced display configuration settings and will replace the old block for new stores. Stores currently using the Cart Cross-Sells block will be able to easily switch to the new block using a newly provided Transform option in the block itself. Read more about this change in the developer advisory below.
Checkout keeps getting better
[#59667]
As we continue to improve the Cart and Checkout block experience, this version delivers major loading improvements to the Cart block. It now renders immediately with skeleton placeholders for cart totals, items, and express payment options while live data loads in the background. Partial loading states also keep everything smooth and responsive when applying discounts or choosing shipping, offering shoppers clear feedback throughout the process.
Simplified block templates
Block templates adopt WordPress’ new Template Registration API, making the template list cleaner and more intuitive. Templates like Products by Category, Single Product, Tag, or Brand now appear under the Site Editor > All Templates > Add Template menu, streamlining the template customization process. The change also ensures WooCommerce templates behave consistently, so customizations respond predictably when themes are switched or templates reverted. Migrating to Template Registration API instantly resolves long-standing bugs and results in a cleaner codebase, making maintenance easier and empowering extension developers to understand and customize the template loading flow.
New Taxonomy Filter block
[#42175]
This version introduces new Taxonomy Filter blocks for Category, Brand, and Tag, offering developers extensive flexibility to extend and customize storefront filtering. These new blocks, powered by the Interactivity API and Product Collection Data enhancements, allow stores to display intuitive, multi-faceted filters that shoppers can combine to precisely refine their searches.
More new features and updates
Improved Analytics reporting:
This version includes several improvements to WooCommerce Analytics report screens. Full refunds are now correctly reflected across Revenue, Product, and Order reports, including returns, net sales, taxes, and shipping. Performance of the Products report has been improved when deleted products are included in results, and CSV exports for variations, customers, taxes, and coupons no longer generate duplicate rows when the page size exceeds 50. These updates make reporting more accurate and reliable, especially when managing refunds.
Improved store launch experience:
[#58973]
This version delivers an improved onboarding flow for new WooCommerce stores, which is fully optimized for mobile and tablet devices. The experience now includes enhanced layouts, better readability, and smoother touch interactions, making it for users to launch and manage new stores on mobile devices.
Experimental/Beta Features
Product Gallery (Beta) layout options improvement
[#59790]
The Product Gallery (Beta) Large Image has always been constrained to a square aspect ratio, which was a significant limitation to layout customization. In this version, we’ve implemented support to add an aspect ratio setting in the Product Image to allow for a cleaner layout of the Single Product page. Stores can still display an original image or crop them to the specific aspect ratio. To use the Product Gallery (Beta) block, from the admin, navigate to Site Editor > Templates > Single Product Page template, replace the Product Image Gallery block with the Product Gallery (Beta) block.
Order Fulfillments (Beta)
This release introduces Order Fulfillments as a new beta core feature. Fulfillments allow merchants to track shipments, handle split or partial fulfillments, and automatically share shipping updates with customers. Store owners benefit from a simple interface for creating and managing shipments, while developers gain a full REST API and extensibility hooks for custom workflows. Draft vs. Fulfilled statuses also let you prepare shipments ahead of time without triggering customer notifications. To try it out, enable the feature with:
wp option update woocommerce_feature_fulfillments_enabled yes
Share your feedback in the GitHub Discussion!
Other important information
Developer Advisories
As mentioned above, the legacy Cart Cross-Sells block is soft-deprecated and replaced by the Product Collection block’s Cross-Sells collection, delivering a faster, more flexible, and highly customizable experience. This change hides the old Cart Cross-Sells block from the inserter, while allowing existing users to continue using it with an option to transform to the new block. New stores will receive the Product Collection Cross-sells block by default, and inserting the Cart block will now include it automatically. Developers should update integrations to leverage the improved, modern Cross-Sells collection for future-proofed compatibility and better user experience. Read the developer advisory for full details.
Database updates
📀 wc_update_1020_add_old_refunded_order_items_to_product_lookup_table Fix inconsistent behavior of net sales in analytic #58744
Changelog
View the full changelog.
Get WooCommerce 10.2
👉 To upgrade: See our update guide or download the latest release from WordPress.org.
🐞 Found a Bug? Please submit a report it on GitHub.
Code Contributors
Leave a Reply