• We are pleased to announce the release of WooCommerce 7.8.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.

    Upcoming PHP Requirement Change

    This release continues to support PHP version 7.3. We recently announced our plan to end support for PHP 7.3, beginning with the release of WooCommerce 8.2.0, scheduled for release in October of 2023. Read our announcement post for full details.

    What’s new in 7.8.0?

    Theme-level Global styles for Cart and Checkout blocks

    If you’re using a block based theme on your store that supports global styles, you can now use these to apply design changes to your Cart and Checkout.

    Head over to the site editor (Appearance > Editor), use the navigation menu to navigate to the Cart or Checkout page on your store and click the page — you can then toggle open the styles sidebar:

    Any changes made to the Typography and Colors sections will now be respected by the Cart and Checkout Blocks:

    Other global styles, such as buttons, are also respected by the cart and checkout blocks now also, for example the checkout place order button:

    Filter by Attribute product counter revamped

    Long awaited improvement of the product counter in the Filter by Attribute block. Since 10.1.0 Filter by Attribute dynamically shows the product counts that are currently displayed based on the whole set of filters on a page.

    You can check out the video below to see the new Filter by Attribute counters in action along with Products blocks:

    New patterns

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

    Hero Product – Split
    Hero Product 3 Split
    Featured Category Triple

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

    Products block improvements

    We have now added the Pick Some Products advance filter to 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:

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

    Mini Cart 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

    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

    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

    akshaya-rane
    ObliviousHarmony
    faisal-alvi
    adrianduffell
    louwie17
    tomalec
    elazzabi
    om4james
    joelclimbsthings
    lanej0
    ravinderk
    jorgeatorres
    aezazs-multidots
    gigitux
    alexiglesias31
    rodelgc
    TarekNabil
    alopezari
    kmanijak
    nielslange
    menakas
    MrJnrman
    nigeljamesstevenson
    psealock
    tyler-paulson
    barryhughes
    opr
    octaedro
    denho
    jeffpaul
    rjchow
    wcstaley
    nathanss
    joshuatf
    ilyasfoo
    mikejolley
    coreymckrill
    Aljullu
    samueljseay
    chihsuan
    cyberwani
    Benunc
    mujuonly
    shadimanna
    Sidsector9
    AashikP
    jonathansadowski
    xristos3490
    Abdalsalaam
    mattsherman
    ashwinparthasarathi
    kshojib
    rrennick
    lsinger
    om4csaba
    dkotter
    EmranAhmed
    jsnajdr
    Konamiman
    thealexandrelara
    minaldiwan
    iyut
    prettyboymp
    vedanshujain
    moon0326
    alishanvr
    bartech
    mdperez86
    peterfabian
    ecgan
    rcstr

    WooCommerce Blocks

    Aljullu
    iamdharmesh
    tjcafferkey
    dnusca
    invalid-email-address
    mikejolley
    wavvves
    senadir
    thealexandrelara
    nefeline
    sunyatasattva
    creative-andrew
    nielslange
    tarunvijwani
    nerrad
    danielwrobert
    leonardola
    imanish003
    szepeviktor
    Sidsector9
    albarin
    roykho
    gigitux
    kmanijak
    kirtangajjar
    opr

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