WooCommerce 10.4 has been released on December 10, 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.4
Interactivity API Mini Cart is now the default
Enable Interactivity API Mini Cart by default.#60823
The Interactivity API-powered Mini Cart has graduated from experimental and is now enabled by default in both development and production environments. This marks a significant milestone in WooCommerce’s adoption of WordPress’s modern frontend architecture.
Previously gated behind the experimental-iapi-mini-cart feature flag, the new implementation replaces the legacy React-based Mini Cart as the standard experience. For merchants and developers, this means improved performance, smaller JavaScript bundles, and better integration with WordPress’s native interactivity patterns.
What developers should know:
- Extensions that customize Mini Cart behavior should test against the new implementation
- The legacy React-based Mini Cart is still available but will be deprecated in a future release
Check the Interactivity API documentation for integration patterns
REST API gets a performance boost
Lazy load WC Admin and Analytics REST API namespaces. #60684
The WooCommerce Admin and Analytics REST API namespaces (wc-admin and wc-analytics) are now lazy loaded on demand—a change that delivers measurable performance improvements for every store.
Check out our in-depth Developer Advisory with testing instructions.
Previously, these controllers loaded on every REST API request, adding over 100ms to response times even when those endpoints weren’t being used. With this optimization, stores can expect TTFB improvements of 30–60ms for requests that don’t need these namespaces.
This is particularly impactful for:
- High-traffic stores where every millisecond counts
- Headless WooCommerce implementations
- Mobile apps using the REST API
- Third-party integrations and custom dashboards
HPOS Datastore caching graduates from experimental
HPOS Datastore caching is now a standard feature. #61521
The HPOS (High-Performance Order Storage) Datastore caching feature has moved out of experimental status and is now available as a standard feature option.
While not enabled by default in this release, developers and agencies can confidently recommend this feature to merchants looking to improve order query performance. Enabling HPOS caching can significantly reduce database load on stores with high order volumes by caching frequently accessed order data. What’s next: We have plans to enable HPOS caching by default in a future release once broader adoption confirms stability across diverse hosting environments.
Block enhancements
Featured Product and Featured Category block supports inner blocks
Featured Category and Featured Product blocks now support inner blocks.#60779
The Featured Product and Featured Category blocks have been updated to support inner blocks, replacing the previous toggle-based approach for showing titles, descriptions, and prices.
This architectural change gives merchants greater flexibility to:
- Customize the layout and order of content elements
- Add additional blocks within Featured sections
- Style individual elements independently
New Category Title and Category Description inner blocks have been added to support this pattern.
Checkout block typography and spacing refinements
Optimized Cart and Checkout block styling.#59787
The Cart and Checkout blocks receive refined typography and spacing throughout for a cleaner, more polished look. Updates include tighter font sizes and improved spacing across checkout form elements, payment methods, order summaries, and action buttons.
Accessibility improvements
WooCommerce 10.4 continues our commitment to WCAG 2.2 conformance with targeted accessibility improvements:
Product Collections Carousel:
- Linked images now have increased padding for better focus area coverage when highlighted
- Navigation button labels have been updated to clearly identify next/previous actions
- Navigation buttons are now visible in mobile and zoomed states
Email templates:
Data tables within emails now use proper semantic markup with <th scope="row"> for row headers, and role="presentation" has been added to layout tables across all WooCommerce email templates, ensuring assistive technologies correctly identify these as layout containers rather than data tables
API Updates
- Add: New GET endpoint for retrieving individual shipping zone methods by instance ID. #61957
- Add: New
/products/catalogendpoint in v3 API (behind feature flag). #61332 - Add: Agentic Commerce checkout sessions route and
completeendpoint (experimental). #61216, #61271 - Add: Webhook functionality for Agentic Commerce protocol. #61325
- Add: HTML tags now allowed in cart product item data fields. #61437
- Fix: Resolves pagination issue causing duplicate results in Variation and Product endpoints. #61410
- Performance: Reduced
get_productcalls in Orders controller. #61438
Other important information
Store API rate limiting fix
Only rate limit POST requests in Store API. #62076
Rate limiting now correctly applies only to POST requests on the checkout endpoint. Previously, PUT requests (used when switching payment methods or updating checkout data) were incorrectly counted toward the rate limit. Customers will no longer hit rate limits during normal checkout interactions—only actual order placement attempts are now rate-limited.
REST API Updates
On-demand loading for Analytics endpoints
The wc-admin and wc-analytics REST API namespaces now load on-demand rather than on every request. This reduces Time to First Byte by 30-60ms for stores using the REST API, particularly benefiting headless storefronts and mobile apps that don’t need analytics functionality on every call. #60684
New Customers v4 endpoint
A new v4 Customers endpoint brings modern architecture patterns and expanded sorting options including name, email, registered_date, orders_count, and total_spend. This makes it easier to build customer management interfaces and integrations. #61336, #61507
Database Updates
📀 This release does include database updates.
• wc_update_1040_add_idx_date_paid_status_parent (PR #61263)
• wc_update_1040_cleanup_legacy_ptk_patterns_fetching (PR #61749)
Changelog
View the full changelog.
Get WooCommerce 10.4
👉 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