WooCommerce 10.2 is coming soon…
The post will track the work we do as we prepare to release 10.2 as well as provide a preview of what’s to come in this new version.
Release Schedule:
- Final Release — September 16, 2025 (rescheduled to September 17)
- See updates
Hey folks, on Monday, August 25th, we kicked-off our Feature Freeze ahead of the release of WooCommerce 10.2. As we begin the testing phase, and get the release ready, we wanted to share some spoilers and document any updates to the expected release timeline.
Check back here for more updates ahead of the WooCommerce 10.2 release, scheduled for September 17, 2025.
What’s coming in 10.2
🎠 Product Collection Carousel: The Product Collection block continues to expand its offerings. This version will introduce a new carousel layout for the Product Collection block, allowing stores to display products in an interactive, scrollable view. This is ideal for showcasing featured collections or seasonal products in a visually engaging way. [#59519, #60013, #60060]
🛒 A faster Cart block: 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. [#59667]
🔀 Introducing the Product Collection block for Cross-Sells: 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.[#60278]
🗂️ Improved taxonomy filters: Stores will now have even more power to refine results, thanks to new filter blocks for Category, Brand, and Tag. Powered by the Interactivity API, these join price and attribute filters, letting buyers easily combine multiple filter types to pinpoint exactly what they want. The new taxonomy filters ensure a seamless experience that integrates with existing filter options for an interactive catalog browsing journey. [#42175]
📐 Simplified block templates: WooCommerce 10.2 adopts WordPress’s new Template Registration API for block templates, making the template list cleaner and more intuitive. Product-related templates like Products by Category, Tag, or Brand now appear directly in the “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. [#60191]
📊 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. [#60258, #60419, #58744]
📱 Improved store launch experience: 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. [#58973]
Experimental/Beta Features
🖼️ Product Gallery (Beta) layout options improvement: The Product Gallery 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. [#59790]
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.
Changelog
Stay tuned for the full changelog available after the Beta 1 release.
Update timeline
✅ Feature Freeze
Added: August 25, 2025
✅ WooCommerce 10.2 Beta 1
Added: September 1, 2025
✅ WooCommerce 10.2 Beta 2
✅ WooCommerce Release 10.2 is live
Scheduled: September 16, 2025 (rescheduled to September 17)
Leave a Reply