WooCommerce 10.4 Officially Released: Comprehensive Upgrades in Performance, Architecture, and Extensibility

WooCommerce 10.4 was officially released on December 10, 2025. This version update is not merely a functional enhancement but a systematic upgrade focused on performance, frontend architecture, API framework, and long-term maintainability. For large-scale e-commerce websites currently in operation that adopt Headless For sites with a REST API-centric architecture or those highly dependent on REST APIs, WooCommerce 10.4 offers clear upgrade value.

I. WooCommerce Version 10.4 Overview

WooCommerce 10.4.0 is a fully backward-compatible stable release, but please note that this updateIncludes database updatesIt is still recommended to perform a full backup before upgrading.

The key points are as follows:

• Release Date: December 10, 2025
• Current version: WooCommerce 10.4.0
• Backward compatibility: Yes
• Database Update: Includes
• Number of submissions: 340
• Number of contributors: 69

From an overall perspective, this update primarily focuses on the following areas:

• Modernizing Front-End Interaction Architecture
• REST API Performance Optimization
• Maturity of the High-Performance Order Storage System
• Enhanced Block System Scalability
• Continuous Improvement of Accessibility Standards

II. Interactivity API Mini Cart Becomes the Default Solution (#60823)

One of the most significant changes in WooCommerce 10.4 is Interactivity API Mini Cart is now the default enabled mini cart solution.This signifies that WooCommerce is fully embracing WordPress's native modern frontend interaction system.

2.1 The Significance of Changes in the Mini Cart Architecture

The new Mini Cart no longer relies on the old one. React This implementation is built on the WordPress Interactivity API, and this adjustment brings multiple benefits:

• JavaScript resources are smaller in size.
• Faster page interaction response
• Highly consistent with WordPress's native frontend mode
• More conducive to long-term maintenance and ecological integration

This feature previously required enabling via an experimental switch, but in 10.4 it has been deemed sufficiently stable for direct use in production environments.

2.2 What Developers and Site Maintainers Need to Be Aware Of

For sites requiring customization, the following key points should be prioritized:

• Plugins and themes that customize Mini Cart behavior require compatibility testing.
• The legacy React Mini Cart is still available for use but has been explicitly placed on a future deprecation path.
• New features should prioritize the extension methods recommended by the Interactivity API.

III. Optimized REST API loading mechanism, significantly improved performance.#60684)

3.1 Admin and Analytics APIs now load on demand

In previous versions, WooCommerce's wc-admin together with wc-analytics The REST API controller willLoaded in every REST API requestEven if the request does not involve backend or data analysis functionality.

WooCommerce 10.4 introduced significant changes to this mechanism:

• The Admin and Analytics APIs are loaded only when they are actually invoked.
• Non-related requests no longer incur additional initialization costs.

3.2 Practical Impact of Performance Improvements

According to official test data, the benefits of this change are very direct:

• API requests that do not use the analytics interface can reduce TTFB by approximately 30–60ms.
• Eliminated the previous inefficient overhead of approximately 100ms per request.

This optimization is particularly critical in the following scenarios:

• High-Traffic WooCommerce Store
• Headless WooCommerce Architecture
• Mobile application calls REST API
• Third-party systems,ERPCRM Interface Integration

4. HPOS Datastore Cache Officially Becomes a Standard Feature#61521)

High-Performance Order Storage is the order data architecture that WooCommerce has prioritized in recent years. In version 10.4, the HPOS Datastore caching feature has officially graduated from experimental status and is now a stable, standard feature option.

4.1 What Problems Does the HPOS Cache Solve?

On high-volume sites, frequent order queries are often the primary source of database performance bottlenecks. Enabling HPOS caching can:

• Cache high-frequency order query results
• Significantly reduce database load
• Improve the overall response speed of backend operations and API requests

4.2 Current Enabled Policies and Future Plans

Something to keep in mind:

• This feature is not enabled by default in WooCommerce 10.4.
• Officially, developers and service providers are advised to proactively enable this feature in suitable environments and evaluate its effectiveness.
• Future versions may enable this feature by default after confirming broader stability.

V. Blockchain System Capabilities Continue to Strengthen#60779)

5.1 Featured Product and Featured Category Support Inner Blocks

WooCommerce 10.4 introduces a structural upgrade to the Featured Products and Featured Categories blocks, officially supporting Inner Blocks.

This change means:

• No longer rely on fixed switches to control the display of titles, prices, and descriptions.
• The order of each element can be freely adjusted.
• Supports inserting additional blocks, such as buttons, text, or icons.
• Each element can be styled independently.

Additionally, the system has introduced new internal blocks: Category Title and Category Description, designed to support the new structural pattern.

5.2 Visual Optimization of Cart and Checkout Blocks

The shopping cart and checkout sections have also received detailed optimizations in this version, including:

• Font sizes are more consistent
• Form spacing is more reasonable.
• Payment Methods and Order Summary Area Made More Clear

The overall visual design is cleaner, enhancing the readability and conversion experience of the checkout process.

VI. Continuous Improvement of Accessibility Experience

WooCommerce 10.4 continues to advance support for the WCAG 2.2 standards, with optimizations across multiple detailed aspects.

6.1 Enhanced Accessibility for Product Collection Carousels

For the Product Collections Carousel, the official team has implemented several improvements:

• Larger image area can be focused
• The Previous Page and Next Page button labels are clearer.
• The button remains visible at all times on mobile devices and when the page is zoomed.

6.2 Semantic Structure Optimization for Email Templates

The table structure in all WooCommerce email templates has been uniformly optimized:

• Data tables use the correct <th scope="row">
• Uniformly add layout tables role="presentation"
• Assistive technologies can correctly distinguish between layout and data content.

VII. Summary of New API Features, Bug Fixes, and Performance Optimizations

7.1 New API Capabilities

WooCommerce 10.4 introduces several new API capabilities, including:

• Method to Retrieve a Single Delivery Zone via Instance ID: GET Interface
• New features added in v3 API /products/catalog Interface (requires functional annotation)
• Agentic Commerce Checkout Session and Completion Interface (Experimental)
• Agentic Commerce Webhook Support
• Shopping cart item data fields support HTML tags.

7.2 Bug Fixes and Performance Improvements

• Fixed duplicate data returned in paginated results for product and variant interfaces
• Reduce unnecessary code in the Orders Controller. get_product Call, improve performance

VIII. Store API Rate Limiting Logic Correction (#62076)

Previously, the rate-limiting logic of the WooCommerce Store API incorrectly counted PUT requests toward the rate-limit threshold, potentially causing users to unexpectedly trigger restrictions during checkout.

In 10.4, this issue has been fixed:

• Rate limiting applies only to POST requests.
• Switching payment methods or updating checkout data will no longer be affected.

This adjustment has significantly improved the actual checkout experience.

IX. Further Enhancement of the REST API Framework (#60684)

9.1 Analytics API On-Demand Loading Further Enhances Performance Advantages

With the Analytics API now loaded on demand, WooCommerce's REST API architecture is better suited for headless and high-performance applications, reducing unnecessary resource consumption.

9.2 Customers v4 Interface Officially Launched#61336(math.) genus#61507)

The all-new Customers v4 interface features a more modern design and supports additional sorting dimensions, such as:

• name and surname
• inbox
• Registration Date
• Order Quantity
• Total Amount Spent

This provides greater flexibility for customer management systems, CRM integration, and data analysis.

summarize

WooCommerce 10.4 is not a version update chasing gimmicks, but a solid upgrade focused on performance, modern architecture, and long-term stability. Whether it's front-end interactions,API Performance and order data storage systems have both taken a step toward greater efficiency and scalability.

Contact Us
Can't read the tutorial? Contact us for a free answer! Free help for personal, small business sites!	Customer Service
① Tel: 020-2206-9892
② QQ咨询：1025174874
(iii) E-mail: info@361sale.com
④ Working hours: Monday to Friday, 9:30-18:30, holidays off