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 10.4.2, is now available for download on WordPress.org and GitHub.

    Changelog

    Bug Fixes

    • Update the Product Collections: Featured Collections to replace the Unsplash image with a CCO licensed image from Pxhere. (9766)
    • Update the Featured Category patterns to replace the Unsplash image with a CCO licensed image from Pxhere. (9765)
    • Update the Product Details patterns to replace the Unsplash images with CCO licensed images from Pxhere. (9764)
    • Update the Hero Product Split pattern to replace the Unsplash image with a CCO licensed image from Pxhere. (9762)
    • Update the Hero Product Chessboard pattern to replace the Unsplash image with a CCO licensed image from Pxhere. (9761)
    • Update the banner pattern to replace the Unsplash image with a CCO licensed image from Pxhere. (9760)
    • Fix error on clearing customizations on Woo Templates that prevented WooCommerce Classic Template block from being displayed. (9759)

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

    Notable Changes

    Enable Single Product block

    We are introducing the Single Product block, which will allow you to select and display any product on a page, post, or template.

    Enable blockified templates

    The blockified version of the Single Product template is now the default template on new plugin installations and for stores enabling a block theme (replacing the old classic template).

    Changelog

    Enhancements

    • Enable Single Product Block. (9714)
    • Product Price: Remove underline on sale price. (9702)
    • Blockified Single Product Template: Use h1 for the Product Title. (9698)
    • Blockified Single Product Template: Add product-classes. (9697)
    • Blockified Single Product Template: Show upsells. (9636)
    • Template Placeholder Design for the Order Received Template. (9602)
    • Mini-Cart: Update cart error notices to be non-dismissable (to match the behavior of the regular Cart). (9578)
    • Classic Product Template block visible in the inserter. (9573)
    • Hide the Product Rating when the product has no reviews. Previously, a link to the Reviews section was displayed. (9556)
    • Reduced the amount of settings data consumed by the cart and checkout blocks. (9552)
    • Enable blockified templates. (9551)
    • Product Categories List: Add “Show child categories only” toggle. (9550)
    • Add Product Rating block to the default Single Product template. (9510)
    • Add support for the Product Rating block within the Single Product template. (9499)
    • The Mini-Cart block is now compatible with caching plugins. (9493)
    • On-Sale Badge: Use background and text color of the button element if not defined in theme.json. (9068)

    Bug Fixes

    • Fix aria-label displaying wrong information on mini-cart. (9672)
    • Allow plugin based template parts in templates. (9667)
    • Prevent horizontal shift when opening the Mini-Cart drawer if scrollbars are visible. (9648)
    • Fix text alignment issue on various widths for Just arrived full hero pattern. (9640)
    • Product Image Gallery Block: Reintroduce filters and override-restore the global product variable. (9630)
    • Remove propTypes definitions from Product List container. (9616)
    • Remove propTypes definitions from Add to Cart. (9615)
    • Revalidate the postcode when changing country in the Checkout form. (9611)
    • Fix an issue where changing country could cause shipping rates to constantly reload. (9606)
    • Fix non visible cart button on mini cart in certain themes. (9603)
    • Fix Mini-Cart badge not visible in themes without a <body> background color. (9601)
    • Fix Cambodian postcode validation. (9597)
    • Product Image Gallery block: Fix magnifying glass appearing outside the block content area. (9594)
    • Exclude already-enqueued scripts from scripts to lazy load in the Mini Cart block. (9587)
    • Fix: Ensure the global product variable is restored to its original value after being overridden within the Add to Cart with Options block. (9581)
    • Fix alignment of the close button in the Mini-Cart drawer when it has borders. (9507)
    • Add to Cart with Options Block: Remove global variable overwrite. (9457)
    • Fix total shipping display info when no shipping method is available. (8819)
    • Blockified Single Product Template: use h1 for the Product Title when transforming from Classic template. (9748)

  • Release Candidate 2 for the June 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 fixes since the release of RC.1:

    • Fixed an issue where text overlapped an image in the task list. #38585
    • Fixed an issue with filtering products by attribute on the orders page. #38593

    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 since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Database Changes

    There are no database changes in the 7.8 release cycle.

    Template Changes

    There have been no new template changes since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Release Schedule

    We’re still on track for our planned June 13 release.

    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 June 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 fixes since the release of Beta.2:

    • Fix issue where undefined query params where not removed from links, causing unexpected behaviour in Analytics. #38542
    • Update WooCommerce Blocks to 10.2.2, which fixes an issue where some scripts needed by the Mini-Cart were not loading. #38545

    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 since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Database Changes

    There are no database changes in the 7.8 release cycle.

    Template Changes

    There have been no new template changes since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Release Schedule

    We’re still on track for our planned June 13 release.

    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.

  • WooCommerce 7.7.2 is available for download. It introduces a few fixes for issues that were introduced in the 7.7.1 release.

    What’s New?

    • Fix some scripts needed by the Mini-Cart block not loading. #9649

    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 June 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 three relatively minor changes since the release of Beta.1:

    • WooCommerce Blocks has been bumped to 10.2.1, which fixes a conflict between the Mini-Cart block and other extensions. #38449
    • A migration link has been added to the onboarding flow. #38441
    • We reverted a PR introduced in Beta.1 that added featured image flag to the API response as a result of some issues discovered in testing. #38460

    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 since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Database Changes

    There are no database changes in the 7.8 release cycle.

    Template Changes

    There have been no new template changes since Beta.1. See the Beta.1 post for changes introduced in 7.8.0-beta.1.

    Release Schedule

    We’re still on track for our planned June 13 release.

    VersionRelease
    Planned Release CandidateJune 6, 2023
    Final ReleaseJune 13, 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.

  • WooCommerce 7.7.1 is available for download. It introduces a few fixes for issues that were introduced in the 7.7.0 release.

    What’s New?

    • Fix Mini-Cart block conflict with Page Optimize and Product Bundles (II) #9586
    • Move template addition to feature flag #38276

    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.

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

    Notable Changes

    We’ve updated the Mini Cart Block editor sidebar to improve its appearance and ease of use. You can see it in action below.

    The Mini Cart Block Settings

    On top of this, we’ve prepared multiple block patterns for products that are available from, the block inserter. Here’s a preview of a few of them in action:

    Chessboard style product details
    Product Details
    Another alternative view for product details

    Other than these features, we’ve released a bunch of other smaller fixes and improvements. The full changelog is below.

    Changelog

    Enhancements

    • Add Banner pattern. (9434)
    • Update Mini-Cart block editor sidebar with a clearer design and texts. (9420)
    • Modernize the block registration for the Add to Cart button. (9404)
    • Add product details pattern. (9408)
    • Fix alignment issue with ‘Add Coupon Code’ button in WooCommerce Blocks. (9392)
    • Add new Product collections: Featured collections pattern. (9388)
    • Classic Product Block: Improve layout and user experience to migrate to blockified templates. (9386)
    • Add the new Product Details: Product listing pattern. (9383)
    • Mini cart: Add color and typography styles on the mini cart title block. (9382)
    • Add new Product listing with gallery pattern. (9347)
    • New Mini Cart count badge which is only visible if there is at least one item in the cart. (9259)
    • [Pattern] Add new Hero product chessboard pattern. (9180)
    • Trigger the set-billing-address from the shipping step. (8841)

    Bug Fixes

    • Fix an issue that caused the color of the Product Meta block icon to not change when the block was selected in the Site Editor’s List View. (9506)
    • Fix an issue that caused the color of the Product Details block icon to not change when the block was selected in the Site Editor’s List View. (9503)
    • Fix Checkout block stepped sections numbers overlapping. (9497)
    • Fix compatibility between the checkout block and the template editor. (9495)
    • Product Search Results Template: Fix compatibility layer when the Product Catalog isn’t blockified. (9492)
    • Product Details block: Show the block when used along the Post Content block. (9479)
    • Fix: Remove the global variable overwrite for the Product Gallery block while still keeping support for the Single Product block. (9475)
    • Archive Templates – Compatibility Layer: Avoid woocommerce_before_shop_loop and woocommerce_after_shop_loop are injected when any products is rendered. (9464)
    • Allow Shipping method prices to inherit global styles text color. (9456)
    • Product Archive Template: Fix compatibility Layer with Product Recommendations extension. (9452)
    • Fixed appearance of checkout form step headings in the editor. (9437)
    • Global Styles: Fix radio control overlap when font-size is small. (9436)
    • Fix COD availability on checkout. (9375)
    • Addressed an issue where a fatal error could sometimes be thrown if a plugin modified a shipping package’s rates incorrectly. (9351)
    • Mini Cart block no longer uses the Modal component from @wordpress/components. (9345)
    • Fix: ensure the global product variable is restored to its original value after being overridden within the Add to Cart with Options block. (9581)

    Performance

    • Removed the block-editor dependency on the frontend. (9251)

  • Beta 1 for the June 13 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.7.0, the following changes have been made:

    • WooCommerce Blocks has been updated to 10.2.0 which includes the following changes. For a full list of changes, see the 10.2.0 release post.
    • The global enqueue of wc-cart-fragments has been removed. (See dev note below) #35530

    For the complete list, view the changelog in the readme for this release.

    Developer Notes

    The Cart Fragments script, responsible for updating the cart widget after a successful add to cart event, can cause a performance issue on stores not making use of that functionality. To mitigate this, the script will now only be enqueued if using the Mini Cart widget.

    Stores with similar functionality (e.g. from a theme) that are not using the widget can re-enable this functionality by either adding the widget to one of their widget areas/sidebars, or by enqueuing the script manually:

    wp_enqueue_script( 'wc-cart-fragments' );

    If you’re looking for an alternative to the Mini Cart widget that does not suffer from the performance issue, try the Mini Cart Block instead.

    Actions and Filters

    This release adds 1 new action and 2 new filters.

    Action

    ActionDescription
    woocommerce_remove_order_itemsTrigger action before removing all order line items. Allows you to track order items. [source]

    Filters

    FilterDescription
    woocommerce_product_add_to_cart_aria_describedbyFilter the aria-describedby description for the add to cart button. [source]
    woocommerce_suggest_jetpackWhen false, Jetpack is removed from the list of suggested extensions. [source]

    Database Changes

    This release has no database changes.

    Template Changes

    This release updates 13 templates

    Template FileGitHub Links
    /templates/cart/cart.php#36868 #37830
    /templates/cart/mini-cart.php#37830
    /templates/checkout/form-pay.php#37514
    /templates/checkout/payment.php#37514
    /templates/global/quantity-input.php#37811
    /templates/loop/no-products-found.php#37514
    /templates/myaccount/downloads.php#37514
    #37933
    /templates/myaccount/form-add-payment-method.php#37514
    /templates/myaccount/orders.php#37514
    #37933
    /templates/myaccount/payment-methods.php#37514
    /templates/order/order-again.php#37933
    /templates/order/order-details.php#37514
    /templates/single-product/product-image.php#37853

    Release Schedule

    We’re on track for our planned June 13 release.

    VersionRelease
    Release Candidate June 6, 2023
    Final Release June 13, 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.

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

    Notable Changes

    Products block improvements

    We have now added the Pick Some Products advance filter to the Products block. This filter allows the merchant to narrow down the exact products to which all subsequent filters will be applied, mirroring the functionality of the existing “Hand-picked Products” plus all the other functionalities available from the “Products (Beta)” block. Here is a quick demo:

    We also added consistent spacing between product elements within the Products block to provide an improved default user interface.

    New patterns

    We prepared multiple patterns that are available in this release. Here’s a preview of a couple of them:

    Hero product 3 split
    Featured Category Cover Image
    Featured Category Triple

    But there’s more! The full list can be found in the Changelog below.

    Mini Cart improvements

    We applied various improvements to the Mini Cart block. The key improvements are:

    • Performance improvement: the Mini Cart drawer will now open instantly. Previously, there may have been a slight delay if the shopper clicked the button immediately after the page loaded and the network was slow.
    • Fix the Mini Cart Contents block display issue with wide widths in the editor. (This feature is available only with the WooCommerce Blocks plugin enabled.)

    Changelog

    Enhancements

    • Products (Beta): Add a filter to allow merchants to hand-pick a subset of products. (7925)
    • Products block: Using nested selectors to add consistent spacing between Product elements. (8993)
    • Make the Mini Cart footer border follow the current text color. (9245)
    • Related Products: Make Product Title a link by default. (9179)
    • Add Shop by Price pattern. (9373)
    • Add Featured Category pattern. (9322)
    • Add Product Collections: Newest Arrivals pattern. (9240)
    • Add WooCommerce Hero Product – Split pattern. (9191)
    • Add Product Hero pattern. (9181)
    • Add Hero product 3 split pattern. (9319)
    • Add Featured Category Cover Image pattern. (9284)
    • Add Featured Category Triple pattern. (9269)
    • Add Product Collections: Featured Collection pattern. (9246)
    • Add Footer with 3 menus pattern. (9175)
    • Add Header Centered Search pattern. (9081)
    • Add WooCommerce Featured Products 5-item grid pattern. (9006)

    Bug Fixes

    • Fix a regression which caused the Mini Cart drawer not to open until its contents have completely loaded. (9329)
    • Fix Mini Cart block not respecting Add-to-Cart behaviour attribute when adding the first product. (9257)
    • Make it so wide widths are correctly applied to the Mini Cart Contents block in the editor. (9201)
    • Prevent email being cleared when changing shipping method or when first entering shipping informaiton. (9328)
    • Fix shipping notices when cart contains multiple packages. (9285)
    • Fix bug in which optional postcodes were still validated. (9377)
    • Product Image Gallery: Fix resize width when the window resizes. (9299)
    • Product Image Gallery: Fix the inline displayed issue. (9297)
    • Single Product Template – Related Products: Fix items per page option. (9286)
    • Prevent Product Price global styles leaking into the Mini Cart, Cart and Checkout blocks. (9276)
    • Fix consistency between editor and frontend button styling. (9260)
    • Performance: Removed lodash dependency on the frontend. (9161)

    Various

    • Update the icon and description for the Product Meta block. (9243)
    • Update the icon and description for the Product Details block. (9241)
    • Rename Add To Cart Form to Add To Cart Options. (9238)