Changelog

Check out the latest releases from the WooCommerce project.
Subscribe to all release posts via our RSS feed.

  • The latest version of WooCommerce Blocks, version 9.8.0, is now available for download on WordPress.org and GitHub.

    Notable Changes

    Better performance and look and feel for the Mini Cart block

    With this release, we introduced many improvements to the Mini Cart block. Among others, it’s been optimized and has better performance. When opening the Mini Cart, the content shows up immediately, as it’s preloaded in the background while the browser is idle.

    The Empty Mini Cart button, which encourages shoppers to add products to the cart, now matches your theme styles.

    Improved Attributes filtering in Products block

    The new Products block now allows filtering products by attribute directly from the Editor interface. The experience has been enhanced by providing a user-friendly collapsible menu with attributes. Additionally, you can quickly filter attributes by typing their name. These enhancements provide a more streamlined experience for selecting the products you want to display.

    Also, when checking the attributes, there’s now a live preview of the products from the Editor perspective, which allows seeing how the block will be displayed in the frontend of your store.

    Improved margins in Products block patterns

    There are a number of available patterns using the Products block. All of them have now consistent and scalable margins.

    Here’s the list of available patterns to try out:

    • WooCommerce 1:1 Image 4-Column Products Row
    • WooCommerce 3-Column Product Row
    • WooCommerce 4-Column Product Row
    • WooCommerce Large Image Product Gallery
    • WooCommerce Minimal 5-Column Products Row
    • WooCommerce Minimal Product List
    • WooCommerce Product Gallery
    • WooCommerce Product list with 1:1 images
    • WooCommerce Product list with full product description

    Dev note

    In this release, we are adding two new filters for the Cart block, they are: proceedToCheckoutButtonLabel and proceedToCheckoutButtonLink.

    By using these filters, developers can alter the text and link of the “Proceed to checkout” button in the Cart. Our documentation has additional information on these filters and an example of how to use them.

    Changelog

    Enhancements

    • Add Product Meta block. #8484
    • Add proceedToCheckoutButtonLabel and proceedToCheckoutButtonLink filters and delete cached filters when registering new ones. #8613
    • Add border style controls to the Mini Cart block. #8654
    • Add support to non-AJAX add to cart in the Products block. #8532
    • Fix mini-cart Start shopping button to follow the current theme styles. #8567
    • Fix: change the “Add-to-Cart behaviour” mini-cart select to a toggle button. #8558
    • Fix: enable global styles for the Product Result Count block. #8517
    • Fix: increase the “Customer account” size icon. #8594
    • Improve Mini Cart drawer close button alignment and make it inherit the text color #8605
    • Made the cart and checkout view switcher compatible with List View in the editor. #8429
    • Preload Mini Cart inner blocks frontend scripts to improve performance #8653
    • Products block: improved UX and UI for the Product Attributes advanced filter. #8583
    • Products: Improve spacing consistency of product elements in patterns. #8401
    • Reduce the number of scripts needed to render a page containing the Mini Cart block #8657 #8703

    Bug Fixes

    • Fix ‘Edit Mini Cart template part’ link in WP 6.2 #8574
    • Fix Mini Cart block having some translations missing in the editor. #8591
    • Fix Mini Cart block inserter preview not showing the cart amount. #8516
    • Fix: remove unnecessary class from the Mini-cart badge. #8557
    • Fixed a bug where quickly clicking through shipping methods would cause UI to update multiple times after the final selection is made. #8498
    • Products block: Fix attributes filters that do not update the editor preview correctly #8611
    • Revert “Show Cart and Checkout blocks in Style Book” #8602

    Technical debt

    • Change the required minimum version from 6.1.1 to 6.1.0. #8649
    • Only call wp.apiFetch.createPreloadingMiddleware() when necessary. #8647

  • RC 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.5 rc 1, the following changes have been made:

    • Upgrade WooCommerce Blocks to 9.6.5 for a host of improvements. You can see the full list of changes in WooCommerce Blocks for more.

    For the complete list of changes in WooCommerce, 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.

    VersionRelease
    Release CandidateMarch 7th, 2023
    Final ReleaseMarch 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.

  • Update: After releasing WC Blocks 9.7.1 we received some reports from the community that it was causing a fatal error in some stores. The issue could be reproduced in WordPress sites which didn’t have Gutenberg enabled. We started investigating it as soon as we learned about it and we released a fixed version soon after: 9.7.2.

    We really appreciate all the feedback and reports we received from the community, it really helps us make WooCommerce better! Thanks a lot for being a part of the WooCommerce community.

    A new version of WooCommerce Blocks has been released! Version 9.7.1 is now available for download from GitHub and WordPress.org.

    Notable changes

    New Blocks

    We’re thrilled to introduce the following new blocks for the Single Product Template. This is our first iteration to port over existing functionalities of the Single Product template to the Site Editor.

    • Single Product Details block: The block version of the product details in the Single Product Template. Merchants can now add product descriptions, information, and reviews to their stores.
    • Add to Cart Form block: The block version of the add to cart form enables merchants to display a button in single product templates. Options are also displayed depending on product type. e.g. quantity, variation.

    Disabling payment gateways stops associated saved payment information from displaying

    We have improved our payment system by preventing saved cards from displaying if the payment gateway that added them is disabled. This ensures that users only see available and enabled payment options, making the payment process more efficient and straightforward.

    Clearer Checkout Events in the Payment System

    We have made changes to the checkout events in our payment system to improve clarity and reduce confusion. Several events were renamed to improve their accuracy and clarity:

    • onCheckoutValidationBeforeProcessing renamed to onCheckoutValidation
    • onCheckoutAfterProcessingWithSuccess renamed to onCheckoutSuccess
    • onCheckoutAfterProcessingWithError renamed to onCheckoutFail
    • onPaymentProcessing renamed to onPaymentSetup

    Fix: Product categories, Product Tags & Keyword filters not working in the Products block

    The following filters should be working fine, which are available in the Inspector Controls of the Products block:

    • Product Categories
    • Product tags
    • Keyword

    Enhancements

    • Add Related Products block. (8522)
    • Products block: Set the Product Title as a link by default. (8519)
    • Add support for the woocommerce_loop_add_to_cart_args filter in the Products block. (8422)
    • Enable the Inherit query from template setting by default for the Products block in archive products templates. (8375)
    • Update the blockified archive templates to use the Products block. (8308)
    • Improve the dismissal behavior of the incompatible gateways notice. (8299)
    • Add the Add to Cart Form block, allowing merchants to display a button so the customer can add a product to their cart. Options will also be displayed depending on product type. e.g. quantity, variation. (8284)
    • All Products: Add alignment settings for the Product Rating and Product Price blocks. (8264)
    • Enable users to migrate to blockified Product Archive templates. (8248)
    • Add Product Image Gallery block. (8235)
    • Add Single Product Details block that displays the product description, information, and reviews. (8225)

    Bug Fixes

    • Add the woocommerce_disable_compatibility_layer filter to disable the compatibility layer. Disable the compatibility layer when Archive Product and Single Product templates contain the WooCommerce Product Grid Block. (8550)
    • Ensure custom shipping methods supporting local pickup show up in the shipping options when no WC Blocks pickup locations are enabled. (8542)
    • Focus the coupon code input when the form is revealed in the cart. (8525)
    • Fix: Make Price product margin work in the All products block. (8518)
    • Fix an issue in which setting the city/state would not persist in the first time for certain customers. (8497)
    • Fix noticeContext declaration in the Shipping calculator. (8495)
    • Update Product Details block so it inherits more styles from the theme. (8494)
    • Fix: Adjust Catalog Sorting colors in dark themes. (8483)
    • Remove opinionated styles from Button component on block themes that define button styles. (8478)
    • Fix individual border controls not showing in the editor for Featured Product and Featured Category blocks. (8472)
    • Fix potential console warnings when certain Checkout Blocks are disabled. (8471)
    • Prevent saved cards from appearing that belong to gateways that are not enabled. (8461)
    • Fix error: “Undefined property $area” error on the BlockTemplatesController. (8443)
    • Fixed an issue where warnings relating to payment method script dependencies were shown when editing pages with Elementor. (8428)
    • Performance – Prevent extra API hydration in the editor when using All Products block. (8413)
    • Product Price: Fix typography styles in the editor. (8398)
    • Fix spacing and display issues for Store Breadcrumbs, Catalog Sorting and Product Result Counts blocks. (8391)
    • Fix Product categories, Product Tags & Keyword filter not working in Products block. (8377)

    Technical debt

    • Rename the checkout events. (8381)

  • 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.

    VersionRelease
    Release CandidateMarch 7th, 2023
    Final ReleaseMarch 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.

    VersionRelease
    Release CandidateMarch 7th, 2023
    Final ReleaseMarch 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.

    Screenshot showing the tool to set specific padding to the Product Rating block

    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 and registerCheckoutFilters 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:

    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.

    FilterDescription
    woocommerce_bacs_email_instructions_order_statusFilter the email instructions order status. [Source]
    woocommerce_cheque_email_instructions_order_statusFilter the email instructions order status. [Source]
    experimental_woocommerce_analytics_variations_additional_clausesExperimental: Filter the Variations SQL query allowing extensions to add additional SQL clauses. [Source]
    woocommerce_admin_experimental_onboarding_tasklistsFilter to override default task lists. [Source]

    Database Changes

    There are no database changes in this release.

    Template Changes

    This release updates 5 templates.

    Template FileGithub 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

    nkls-so
    MMTE
    chihsuan
    nima-karimi
    louwie17
    barryhughes
    MatzeKitt
    jeremylind
    Konamiman
    davefx
    Dekadinious
    leskam
    puntope
    helgatheviking
    jorgeatorres
    vedanshujain
    wvega
    tammullen
    rodelgc
    adrianduffell
    rjchow
    rodrigoprimo
    IanDelMar
    jonathansadowski
    mdperez86
    ecgan
    joris-iSide
    timur987
    alexmigf
    Facyla
    samueljseay
    dd32
    nigeljamesstevenson
    gigitux
    joelclimbsthings
    roykho
    ilyasfoo
    mattsherman
    thilinah
    nathanss
    mujuonly
    joshuatf
    shaybanshee
    matt-h
    psealock
    sebcode
    moon0326
    priyankabehera
    octaedro
    horzu
    Aljullu
    SavPhill
    sunyatasattva

    ActionScheduler

    roykho
    Konamiman
    JosephGabito
    jorgeatorres
    jonathanstegall
    rrennick
    rodrigoprimo
    barryhughes
    jonathansadowski
    ObliviousHarmony
    alexmigf
    bahiirwa
    crstauf
    WPprodigy
    vedanshujain

    WooCommerce Blocks

    gigitux
    tarunvijwani
    danielwrobert
    sunyatasattva
    senadir
    kmanijak
    ralucaStan
    lukeoregan88
    wavvves
    opr
    danieldudzic
    dinhtungdu
    alexflorisca
    imanish003
    stian-overasen
    nielslange
    nefeline
    tarhi-saad
    Aljullu
    rodrigoprimo
    albarin
    mikejolley

  • 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.