Changelog
Check out the latest releases from the WooCommerce project.
Subscribe to all release posts via our RSS feed.
-
WooCommerce 7.4.1 is now available for download.
What’s new?
This release bumped the version of WooCommerce Blocks included in WooCommerce to 9.4.4.
Version 9.4.4 of WooCommerce Blocks fixes an issue that had the potential to cause errors with some extensions when the tax address was filtered before the session was initiated. #8537
You can download the latest release of WooCommerce here or visit Dashboard → Updates to update the plugin from your WordPress admin screen.
As usual, if you spot issues in WooCommerce core, please log them in detail on GitHub. Found a security issue? Please submit a report via HackerOne.
-
Beta 2 for the March 2023 release of WooCommerce is now available for testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.
Highlights
Since the release of 7.5 beta 1, the following changes have been made:
- Upgrade WooCommerce Blocks to 9.6.2 to fix a bug
For the complete list of changes, view the changelog in the readme for this release.
Actions and Filters
No changes introduced.
Database Changes
No changes introduced.
Template Changes
No changes introduced.
Release Schedule
We’re still on track for our planned March 14 release.
Version Release Release Candidate March 7th, 2023 Final Release March 14th, 2023 Testing
If you’d like to dive in and help test this new release, our handy WooCommerce Beta Tester plugin allows you to switch between beta versions and release candidates. You can also download the release from WordPress.org.
A set of testing instructions has been published on our Wiki page in GitHub. We’ve also posted a helpful writeup on beta testing to help get you started.
If you discover any bugs during the testing process, please let us know by logging a report in GitHub.
-
At present, WooCommerce follows an L-2 support policy, meaning it supports the latest version of WordPress and the two preceding versions. This approach was chosen to ensure optimal performance and stability as WordPress Core evolves.
By limiting the range of WordPress versions that can be used with WooCommerce, we are able to allocate resources, including testing, more effectively to ensure that WooCommerce runs smoothly, free from errors and bugs.
While our previous L-2 support policy served us well, we have decided to go one step further by adopting an L-1 support policy starting with WooCommerce 7.8 in June of 2023. This change will only affect merchants who choose to update WooCommerce regularly but elect not to keep their WordPress installations up to date.
Under the new policy, WooCommerce will support the latest version of WordPress and the previous version. For instance, WooCommerce 7.5 would be compatible with:
- WordPress 6.1, the current version.
- WordPress 6.0, the previous version.
This change will help minimize the risk of introducing bugs, promote faster adoption of new WordPress features, and encourage merchants to stay up to date with relevant security and bug fixes for both WooCommerce and WordPress.
What action should I take?
To make sure you are up-to-date with relevant security and bug fixes for both WooCommerce and WordPress, make sure to keep your versions as closely in sync as possible.
-
Beta 1 for the March 2023 release of WooCommerce is now available for testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.
Highlights
Since the release of 7.4, the following changes have been made:
- Add a new Channels card in multichannel marketing page
Many bug fixes and improvements were also added.
For the complete list, view the changelog in the readme for this release.
Actions and Filters
No changes introduced.
Database Changes
No changes introduced.
Template Changes
No changes introduced.
Release Schedule
We’re still on track for our planned March 14 release.
Version Release Release Candidate March 7th, 2023 Final Release March 14th, 2023 Testing
If you’d like to dive in and help test this new release, our handy WooCommerce Beta Tester plugin allows you to switch between beta versions and release candidates. You can also download the release from WordPress.org.
A set of testing instructions has been published on our Wiki page in GitHub. We’ve also posted a helpful writeup on beta testing to help get you started.
If you discover any bugs during the testing process, please let us know by logging a report in GitHub.
-
A new version of WooCommerce Blocks has been released! Version 9.6.1 is now available for download from GitHub and WordPress.org.
Notable changes
Global Styles
The Product Rating block has gained support for padding global styles, making it easy to add spacing around it.
Feature graduation – Checkout Filters
In this release, we graduated two functions from experimental to stable, the work was carried out in PR #8346 which contains more information. The functions we graduated are:
-
__experimentalApplyCheckoutFilter
-
__experimentalRegisterCheckoutFilters
These functions are now named:
applyCheckoutFilter
andregisterCheckoutFilters
respectively.This change comes after a long period of assessment to decide if this is a good approach for extensibility and we decided that it is.
How to upgrade
To upgrade and to ensure your integrations continue to work, please simply rename all uses of the experimental functions to use the new stable names.
Next steps
We will leave a notice in the JavaScript console for at least 6 months to alert developers who continue to use the experimental functions that they can upgrade. This will be in place until at least version 10.9.0 at which point we will remove the experimental functions.
Enhancements
- Improved default headings and styling of the cart block and fixed the display of cart and checkout block editable fields when using dark themes. (8380)
- Add a reset button for the Filter blocks. (8366)
- Update the incompatible gateways notice design. (8365)
- Product Rating: Add support for the Padding setting. (8347)
- Update apply button description to be more clear for filter blocks. (8339)
- Allow third party shipping methods to declare compatibility with WC Blocks local pickup. (8256)
Bug Fixes
- Fix a bug where certain checkout fields were being reset when changing the shipping option. (8400)
- Fix bug in which errors would be shown twice in Checkout block. (8390)
- Filter by Rating: Fix functionality to for resetting filters using the Reset button. (8374)
- Fix a bug in WordPress 5.9 in which changing quantity doesn’t work inside Cart and Mini Cart blocks. (8356)
- Fix potential conflict between newsletter extensions on the checkout page. (8354)
- Mini Cart block: Fix the drawer content height to allow the checkout button to be visible. (8351)
- Prevent errors relating to the coupon input disappearing when focusing/blurring the coupon input and the value of the input field remains unchanged. (8349)
- Fix: The experimental typography styles for the Store Breadcrumbs block are now restricted to the feature plugin. (8345)
- Fix console error of
isLoading
for Price filter block. (8340) - Checkout – Allow partial pushes of address data to work before a country is provided (8425)
- Make Mini Cart Contents block visible in the Style Book. (8458)
- Fixed an issue where cart item data could cause fatal errors if it was an array. (8440)
- Fix Customer account sidebar link incorrect margin in WP 6.2. (8437)
- Fix cases in which Checkout would validate customer country against the wrong state. (8460)
-
-
We are pleased to announce the release of WooCommerce 7.4.0. This release should be backwards compatible with the previous version.
This release contains:
- 274 commits from 63 contributors in WooCommerce Core.
- 220 commits from 27 contributors in WooCommerce Blocks.
As always, we recommend creating a backup of your site and making sure that your theme and any other plugins are compatible before updating. You can check out this update guide for more information.
What’s new in 7.4.0?
The new Local Pickup
WooCommerce Blocks 9.4.0 comes with the new Local Pickup experience, allowing you to offer a streamlined, dedicated pickup experience to your customers.
Local Pickups comes with a new shipping method toggle block, and an admin screen to manage locations.
New Customer Account block is now available
This block contains a link to the Login and My Account pages and was added to the Header and Footer patterns. It’s possible to customize this block to be displayed as text-only, icon-only, or icon and text. You can also select the icon style.
Highlight incompatible payment gateways within the Cart & Checkout Blocks
If you use any incompatible payment gateways, you will now get a warning notice in the editor side of the `Cart` & `Checkout` Blocks:
In the `Payment Options` Inner Block of the `Checkout` Block, we also display a warning under incompatible payment gateways:
Display “Add review” link when product has no rating
If a product has no ratings, an “Add review” link appears instead of stars. The idea is to help preserve the layout and eventually be a consistent way to link shoppers directly to the rating results for the product.
Apply rate limiting to non-admin users only
If you enable the rate limiting filter for Store API, it will only be applied to non-admin users. You can now edit your Blocks without being restricted by the rate limiting on the admin side!
Cart & Checkout buttons are editable
On the Cart Block, the “Proceed to Checkout” button text is now editable in the editor. On the Checkout block, the “Place Order” button text is also editable. These will default to the original text if left empty.
Simplified account creation settings in Checkout Block
We’ve removed some duplicate settings related to creating accounts and logging in during the checkout process. These settings are now pulled from WooCommerce Core and respected inside the Checkout Block.
Non-ASCII support for Filter by Attribute Block
You can now add non-ASCII product attributes and they will be respected by the Filter by Attribute Block.
Actions and Filters
This release adds 4 new filters and no new actions.
Filter Description woocommerce_bacs_email_instructions_order_status
Filter the email instructions order status. [Source] woocommerce_cheque_email_instructions_order_status
Filter the email instructions order status. [Source] experimental_woocommerce_analytics_variations_additional_clauses
Experimental: Filter the Variations SQL query allowing extensions to add additional SQL clauses. [Source] woocommerce_admin_experimental_onboarding_tasklists
Filter to override default task lists. [Source] Database Changes
There are no database changes in this release.
Template Changes
This release updates 5 templates.
Template File Github Links templates/cart/cart.php
#36247 templates/emails/email-footer.php
#36310 templates/emails/email-header.php
#36310 templates/emails/email-styles.php
#36310 templates/global/quantity-input.php
#36460 Much 💜 to all the contributors
Finally a big thanks to everyone in the community who has contributed via issue reports, fixes, translation, testing, supporting other users, or simply spreading the word.
WooCommerce Core
ActionScheduler
WooCommerce Blocks
-
Release Candidate 2 for the February 2023 release of WooCommerce is now available for testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.
What’s New?
There has been one relatively minor fix since the release of RC.1:
- Correct the list of plugins displayed in the onboarding flow, by adding Omnichannel for WooCommerce to the list. #36766
See the full changelog for all of the changes included in this release.
Actions and Filters
There have been no new action or filter changes changes since RC.1. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Template Changes
There have been no new template changes since RC.1. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Release Schedule
We’re still on-track for our planned February 14, 2023 release of WooCommerce 7.4.
Testing
If you’d like to dive in and help test this new release, our handy WooCommerce Beta Tester plugin allows you to switch between beta versions and release candidates. You can also download the release from WordPress.org.
A set of testing instructions has been published on our Wiki page in GitHub. We’ve also posted a helpful writeup on beta testing to help get you started.
If you discover any bugs during the testing process, please let us know by logging a report in GitHub.
-
Release Candidate 1 for the February 2023 release of WooCommerce is now available for testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.
What’s New?
There have been two relatively minor fixes since the release of Beta.2:
- WooCommerce Blocks has been updated to 9.4.3, which contains a fix for changing the quantity inside the Cart and Mini Cart blocks in WordPress 5.9. #36736
- We rolled back a change introduced in Beta.1 that updated the spelling of ‘cancelled’, as we identified that it had the potential to cause issues for plugins that relied on the original string. #36714
See the full changelog for all of the changes included in this release.
Actions and Filters
There have been no new action or filter changes changes since Beta.2. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Template Changes
There have been no new template changes since Beta.2. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Release Schedule
We’re still on-track for our planned February 14, 2023 release of WooCommerce 7.4.
Testing
If you’d like to dive in and help test this new release, our handy WooCommerce Beta Tester plugin allows you to switch between beta versions and release candidates. You can also download the release from WordPress.org.
A set of testing instructions has been published on our Wiki page in GitHub. We’ve also posted a helpful writeup on beta testing to help get you started.
If you discover any bugs during the testing process, please let us know by logging a report in GitHub.
-
A new version of WooCommerce Blocks has been released! Version 9.5.0 is now available for download from GitHub and WordPress.org.
Notable changes
Support for Style Book
Gutenberg 14.8 introduced Style Book, which allows merchants, web developers and site admins to preview individual blocks. With the WooCommerce Blocks 9.5.0 release, the Featured Product and the Featured Category blocks are available here. This will enable the preview of any global style changes applied to these blocks.
Global Styles
Besides previewing blocks within the Style Book, we also migrated various blocks away from hardcoded CSS towards Global Styles. Since WooCommerce Blocks 9.5.0, the Product Button, Product Rating, and Product Price blocks utilise Global Styles.
New Blocks
In addition to the Story Book and Global Styles improvements, we’re thrilled to introduce the following new blocks:
- Store Breadcrumbs block: Provides a clear and easy-to-follow navigation trail, allowing users to quickly understand their location within the store and facilitating navigation to previous sections.
- Product Results Count block: Displays the total number of products and how many are currently displayed, based on the global query.
- Catalog Sorting block: Allows users to sort products within a category by various criteria, such as price, popularity, and newness.
Enhancements
- Enhancement: Add border style previews in the editor for featured items. (8304)
- Enhancement: Add a reset button for the Filter by Attributes block. (8285)
- Enhancement: Graduate margin styling for Product Price block to WooCommerce core. (8269)
- Enhancement: Set inherit setting to true when is inserted in the archive product template. (8251)
- Enhancement: Prevent an edge case where adding the Product blocks above the Classic Template block would cause its ratings to change the markup. (8247)
- Enhancement: Improve free local pickup display during checkout. (8241)
- Enhancement: Transition Product Button from using CSS margin to Global Styles. (8239)
- Enhancement: Refresh the cart after using the back button to return to checkout. (8236)
- Enhancement: Add Store Breadcrumbs block, allowing merchants to keep track of their locations within the store and navigate back to parent pages. (8222)
- Enhancement: Move margin for Product Rating from CSS to Global Styles. (8202)
- Enhancement: Add a compatibility layer to keep extensions continue working with Blockified Archive Templates. (8172)
- Enhancement: Add Catalog Sorting block. (8122)
- Enhancement: Add Product Results Count block. (8078)
- Enhancement: Improve how checkout pushes data to the server when entering address data. (8030)
- Enhancement: Replace the collapsed section for the coupon code with a link. (7993)
Bug Fixes
- Fix: Adjust Featured Product and Featured Category blocks preview for Style Book. (8313)
- Fix: Hide filter blocks and Product Search block for Style Book. (8309)
- Fix: Resolve a bug that would display Billing Address for Shipping Address on checkout rest endpoint. (8291)
- Fix: Adjust color and direction of the arrow of the return to cart button on the checkout page. (8289)
- Fix: Adjust Store Notices text color in dark themes. (8278)
- Fix: Adjust Catalog Sorting colors in dark themes. (8270)
- Fix: Resolve an issue where the WooCommerce tab of the style book would crash, and certain blocks would not load correctly. (8243)
-
Beta 2 for the February 2023 release of WooCommerce is now available for testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.
What’s New?
There have been two relatively minor fixes since the release of Beta.1:
- Removal of the new navigation from WooCommerce Admin. #36456
- WooCommerce Blocks has been updated to 9.4.2. #36624
See the full changelog for all of the changes included in this release.
Actions and Filters
There have been no new action or filter changes changes since Beta.1. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Template Changes
There have been no new template changes since Beta.1. See the Beta.1 post for changes introduced in 7.4.0-beta.1.
Release Schedule
Version Release Planned Release Candidate February 7, 2023 Final Release February 14, 2023 Testing
If you’d like to dive in and help test this new release, our handy WooCommerce Beta Tester plugin allows you to switch between beta versions and release candidates. You can also download the release from WordPress.org.
A set of testing instructions has been published on our Wiki page in GitHub. We’ve also posted a helpful writeup on beta testing to help get you started.
If you discover any bugs during the testing process, please let us know by logging a report in GitHub.