Changelog
Check out the latest releases from the WooCommerce project.
Subscribe to all release posts via our RSS feed.
-
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.
Customer account block selected 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.
Product with Add review link 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.
Editable button in the Checkout block Editable button in the Cart block 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.
-
Beta 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.
Highlights
- WooCommerce Blocks has been updated to 9.4.0, which includes:
See the full changelog for all of the changes included in this release.
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] 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 Release Schedule
Version Release Beta January 24, 2023 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.
-
A new version of WooCommerce Blocks has been released! Version 9.4.0 is now available for download from GitHub and WordPress.org.
The new Local Pickup
WooCommerce Blocks 9.4.0 comes with the new Local Pickup experience, 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.
Various other bug fixes, enhancements, and updates to documentation are detailed in the changelog below.
Changelog
Enhancements
- Product Elements: Change the color of product elements (variations of core blocks) icon blocks to match the color of the core blocks. (8155)
- Added context for aria-label on cart quantity controls. (8099)
- Add Local Pickup shipping method and its blocks. (7433)
Bug Fixes
- Prevent undefined variable notice on checkout. (8197)
- Allow Slot/Fills in the Cart and Checkout blocks to correctly render in the Block Editor. (8111)
- Attribute, Rating and Stock filters: Dropdown indicator icon display fix. (8080)
- Ensure the filter controls are consistently displayed in the editor. (8079)
- Ensure the Checkout Totals and Checkout Order Summary blocks cannot be removed from the Checkout block. (7873)
Documentation
- Add Customer Account block name to readme.txt. (8114)
Technical debt
- Update validation messages to reference the name of the invalid field. (8143)
Compatibility
- Update minimum PHP required version to 7.2. (8154)
-
We are pleased to announce the release of WooCommerce 7.3.0. This release should be backwards compatible with the previous version.
This release contains:
- 162 commits from 44 contributors in WooCommerce Core.
- 115 commits from 21 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.3.0?
- Add Pinterest and Codisto extensions to the onboarding wizard. (#36003, #36009)
- Add a warning banner to the user when the tax settings are mismatched and in conflict. (#36010)
- Product management: improve the UI for creating attributes (#35904) and guidance around product image size and format (#35834)
- Add a new Products block, which allows listing products choosing specific criteria, as well as controlling the layout of the products in the list/grid by the various element blocks. It’s currently labelled beta because we’re still polishing it, but look forward to any feedback you can provide on the block.
- Add 3 “commerce-adjacent” patterns for WooCommerce stores. “Commerce adjacent” means that the patterns are not connected to any WooCommerce data, which gives a bit more flexibility around what you link to, the images used etc.
- Add one-click installation feature in our multichannel marketing experience (beta). You can now directly install our recommended marketing extensions that are available in WordPress.org plugins directory, without leaving wp-admin dashboard.
Installation of MailPoet plugin is in progress. These are just some of the changes that are included in WooCommerce 7.3.0. You can find the complete changelog for this release in the changelog.txt file.
Actions and Filters
- ‘woocommerce_’ . $this->order_type . ‘_list_table_custom_column’ Fires for each custom column for a specific order type. This hook takes precedence over the generic action
manage_{$this->screen->id}_custom_column
. - ‘woocommerce_’ . $this->order_type . ‘_list_table_request’ Allows 3rd parties to filter the initial request vars before defaults and other logic is applied.
- ‘woocommerce_’ . $this->order_type . ‘_list_table_prepare_items_query_args’ Same as
woocommerce_order_list_table_prepare_items_query_args
but for a specific order type. - ‘woocommerce_’ . $this->order_type . ‘_list_table_default_statuses’ Allows 3rd parties to set the default list of statuses for a given order type.
- ‘woocommerce_’ . $this->order_type . ‘_list_table_order_count’ Allows 3rd parties to modify the count of orders by status.
- ‘woocommerce_order_list_table_restrict_manage_orders’ Fires before the “Filter” button on the list table for orders and other order types.
- ‘woocommerce_order_list_table_extra_tablenav’ Fires immediately following the closing “actions” div in the tablenav for the order list table.
- ‘woocommerce_’ . $this->order_type . ‘_list_table_columns’ Filters the list of columns.
- ‘woocommerce_’ . $this->order_type . ‘_list_table_sortable_columns’ Filters the list of sortable columns.
Database Changes
There are no database changes in this release.
Template Changes
- templates/cart/cart-shipping.php
- templates/emails/customer-on-hold-order.php
- templates/emails/plain/customer-on-hold-order.php
- templates/global/quantity-input.php
- templates/taxonomy-product-attribute.php
Deprecations
There are no deprecations in this release.
WooCommerce Core
WooCommerce Blocks