WooCommerce 8.8 has been released!
This post will highlight what’s included in this version of WooCommerce.
See our update guide.
Download directly from WordPress.org.
Other important information:
- This release is compatible with WordPress 6.5.
- This release does not include a database change.
- See more
Latest version:
About:
- ✅ Backwards compatible
- Commits: 325
- Contributors: 91
Release Schedule:
- Final Release — April 17, 2024
- See updates
What’s coming in 8.8
- Introducing: a new way to Customize Your Store
- New “Post-purchase note” field added to the Product Editor
- New design for the Product Editor header
- Making the product onboarding list and product tour extensible
- Allowing block notice templates in classic themes
- Enhanced number formatting for Campaign Cost and Sales
- New totalValue filter
- More flexible product attributes term selection
- Automatic Installation of the Legacy REST API Plugin
- Improve local pickup flow
- Other important information
- Update timeline
Introducing: a new way to Customize Your Store
[EPIC] Customize your Store – Pattern Assembler #43623

The new Customize Your Store feature allows merchants to easily design the look and feel of their online store without coding. Merchants can choose from predefined color palettes, fonts, headers, footers and more using an intuitive pattern assembler interface. This innovative upgrade replaces the previous personalization onboarding task and leverages WordPress’ powerful site editing capabilities. Merchants can now spend more time growing their business and less time wrestling with themes and code.
Read more about this feature here.
New “Post-purchase note” field added to the Product Editor
Add – Post-purchase note field to the Inventory tab #45244

Merchants can now enter a custom “Post-Purchase Note” that will be included in order confirmation emails sent to customers. This new field has been added under the “Inventory” tab when editing individual products. It allows store owners to personalize each order confirmation with any additional messages, terms, or other information for the customer regarding their purchase. The note entered here will display just like the custom messages entered in the classic product data interface. This small but useful addition gives merchants more flexibility to communicate with customers post-purchase directly from the product page.
New design for the Product Editor header
Update – Modify product header #44711

This release includes improvements to the product editor interface. The cover image is now displayed next to the product name for better visual hierarchy. Draft
and Hidden
product statuses are clearly indicated with new tags. The tag Draft
is added when the product is a draft or scheduled. The tag Hidden
is added when the product is hidden in the catalog and hidden from search results.
Making the product onboarding list and product tour extensible
Allow extensions in Add Products task #44892
Proof of Concept for allowing product tour to be extensible #45617

Custom product types can now be added to the Add Products onboarding task list.
To add a new product type to the list, use the new experimental_woocommerce_tasklist_product_types
JavaScript filter. JavaScript filters can be added via the addFilter
function from the @wordpress/hooks package.
You can also now customize the product tour that is shown when creating a product from the onboarding list, this can be done with the new experimental_woocommerce_admin_product_tour_steps
filter.
These changes have been introduced in #44892, #45617
For more information, check out our recent post: Making Product Onboarding and Product Tours Extensible.
Allowing block notice templates in classic themes
Allow usage of block notice templates when using classic themes #45164

This screenshot shows the block notice template when using the following Storefront child theme.
Previously in WooCommerce, block notice templates could only be used in block themes. WooCommerce 8.8 introduces the ability for theme developers to display block notice templates even when using a classic theme. This can be done in two ways:
- Applying the filter
add_filter( 'woocommerce_use_block_notices_in_classic_theme', '__return_true' );
to the site. - Overwriting the notice templates as explained in Tutorial: Overriding notice templates.
This change gives theme developers more flexibility to customize the notice experience for their users.
Enhanced number formatting for Campaign Cost and Sales
Add formatting for Cost and Sales numbers in Campaigns card in Marketing page #44917

This release includes improved number formatting for the “Cost” and “Sales” fields displayed in the “Campaigns” card on the Marketing page. Numbers will now be formatted according to the currency and locale settings of the site administrator. This means decimals, thousands separators, currency symbols and more will match how numbers are typically written for the selected currency and location. This small change makes at-a-glance tracking of campaign finances clearer for store owners around the world.
New totalValue
filter
Add – Add totalValue filter #45170
Some extensions, e.g. WooCommerce Deposits, require formatting the total price. To enable them to format the total price in the footer of the Cart and Checkout blocks, we’ve added a new filter called totalValue
. For example:
Without the filter:

With the filter:

See our technical documentation for details on parameters and return values.
More flexible product attributes term selection
Add a filter woocommerce_admin_terms_metabox_datalimit
to change the data-limit value for the attributes term box #45506
WooCommerce 8.8 introduces a new filter woocommerce_admin_terms_metabox_datalimit
that merchants can use to customize the number of terms shown in the product attributes term box. This change was made to help stores with large numbers of attributes that have similar names more easily find the correct term when editing products. The default limit is still 50 terms, but stores can now override this on a case-by-case basis as needed.
Automatic Installation of the Legacy REST API Plugin
Add the plugin install engine #44856
Install the Legacy REST API plugin on WooCommerce upgrade if needed #45570
We’re removing the Legacy REST API from WooCommerce in 9.0. To provide a path forward for sites that still rely on it, we’ve extracted the API into its own plugin and released it to the .org directory.
To minimize the risk of things breaking, we’re now detecting when a site still uses the Legacy REST API and if so automatically install the plugin from the .org directory. This way automatic updates won’t break these sites even if WooCommerce itself removes support for this API.
Improve local pickup flow
Improve local pickup flow #45614
Merchants using local pickup will benefit from an enhanced onboarding and configuration experience. The local pickup settings are now more prominently featured in the shipping zones interface. This makes it easier for stores to set up pickup locations via the new Local Pickup settings page. The update also aims to better distinguish between legacy and new local pickup methods. Merchants already using the legacy method will see recommendations to transition to the more full-featured new local pickup solution. Overall, the changes improve merchant understanding and adoption of WooCommerce’s local pickup options.
Other important information
Fixed Coupon Extension Compatibility
Set access modifier for $error_message to public and added a setter method #46642
Added: April 17, 2024
This release includes a fix for a compatibility issue that could cause errors when using third-party coupon extensions alongside WooCommerce. The $error_message property on coupons was changed from protected to public access to prevent fatal errors in certain situations.
A new plugin to facilitate Woo.com product updates
Remove the ability to update Woo.com extensions not available in WP.org plugin directory #44279
Added: March 26, 2024
The code for handling plugin and theme updates will be moving to a separate plugin and out of WooCommerce core. This is to affirm our compliance with WordPress.org’s guidelines, as well as to provide continued enhancements to how plugins and themes purchased from Woo.com are installed and updated.
For more information, check out our post: Introducing A New Plugin to Facilitate Woo.com Product Updates.
Install routines no longer alter fresh_site
option
[Launch Your Store] Disable WP fresh_site action when WooCommerce pages are added #45219
WooCommerce’s install routines will no longer alter the value of the WordPress fresh_site
option. Previously, the creation of default store pages in the install routines would fire a hook in WordPress that would set the value to 0
. To ensure a new WordPress site with WooCommerce has a fresh_site
option value of 1
, we have disabled the hook from running in the WooCommerce install routines.
Database Changes
This release does not include a database change.
Update timeline
WooCommerce 8.8.2 released
Added: Apr 17, 2024
WooCommerce 8.8.2 has been released.
See our update guide.
Download directly from WordPress.org.
WooCommerce 8.8.1 stable tag reverted
Added: Apr 15, 2024
Between approximately 14:43 and 15:16 UTC, WooCommerce 8.8.1 was briefly set as the stable version on WordPress.org. The current stable tag has been reverted to WooCommerce 8.7. WooCommerce 8.7 is the current production-ready version.
We’re currently working to re-release WooCommerce 8.8 and update the stable tag.
For more information about this, please see our latest developer advisory.
WooCommerce 8.8 delayed
Update: Apr 12, 2024
The release of WooCommerce 8.8.1 has now been scheduled for Monday April 15.
Added: Apr 10, 2024
During our pre-release smoke tests, we discovered an unexpected change in the title of the shop page from “Shop” to “Products” in WooCommerce version 8.8. This change was not anticipated and was potentially caused by updates in the template structure.
The issue is reproducible, and we are currently addressing it. You can follow the progress of that work in PR #46429.
However, we want to investigate further for any additional impact this could have, as well as taking the opportunity to add more automated testing around this specific code.
Note: 8.8 is already available on WordPress.org
The release is currently available on the WordPress.org plugin page. Consequently, we have not updated our stable tag in order to prevent automatic updates. The bug was discovered during our 8.8 release process where an additional set of tests run once the release is available on WordPress.org.
8.8.1 will be released early next week with a fix for the issue. The exact date will be announced later this week once we’ve fully completed testing the fix.
Addressed issue where Analytics failed to load when filtering by a specific product.
Remove accidental count call within an is_array check #45939
Fixed a bug with WCPayPromotionDataSourcePoller
fatal error when upgrading from a previous version.
Fix DataSourcePoller footer error on upgrade downgrade #45892
Reposted from WooCommerce
If you have a care plan with 7th Circle Designs this update will be taken care of based on your plan’s schedule. If you do not have a care plan, sign up now.