Changelog

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

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

    This release is fully compatible with WooCommerce 4.6, scheduled to be released tomorrow, and includes several bug fixes to the Checkout block payment flow.

    We’ve also updated the blocks styles so that they’re loaded after the WP editor CSS, ensuring blocks look more similar between the frontend of the store and the editor.

    For developers

    We fixed an inconsistency in the payment methods API with the retry property in the checkoutAfterProcessingWithSuccess/Error observers. Now it defaults to true if it’s not defined. We also introduced a shouldRetry method that allows adding more complex rules to whether a payment method should offer a customer the option to retry after a failed payment. You can read more details in the Checkout Block Flow documentation.

    We’ve also changed how the payment method tabs are loaded: prior to this release the content of all tabs was rendered on page load, but with this update, only the content of the selected tab will be rendered. This will ensure better performance for sites with many payment methods and will remove the need for payment gateways to check if they are the active one or not.

    Changelog

    Bug fixes

    • Make ‘retry’ property on errors from checkoutAfterProcessingWithSuccess/Error observers default to true if it’s undefined. (3261)
    • Ensure new payment methods are only displayed when no saved payment method is selected. (3247)
    • Load WC Blocks CSS after editor CSS. (3219)
    • Restore saved payment method data after closing an express payment method. (3210)

    Refactors

    • Don’t load contents of payment method hidden tabs. (3227)

  • After releasing the beta version last week we found a few issues that needed fixing. We fixed those issues and are moving ahead according to the plan. We’re excited to announce that the release candidate is now available! We are on track for our planned October 13 WooCommerce 4.6 final release date.

    Fixes

    Since the beta version, the following fixes were added:

    • Redirect users to setup wizard when WooCommerce is activated (#5214 and #5230).
    • Enlarged store profiler text in two steps (#5194).
    • Bug where sometimes the task list would not vanish after being completed (#5205).

    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.

    Thanks to all of our testers and contributors!

  • There’s a new version of the WooCommerce Blocks plugin. Version 3.5.0 is now available on WordPress.org and GitHub.

    This release is mostly a fix release with more enhancements around payment methods.

    More resilient payment methods. When a payment method fails registration, the other will continue to be working.

    Changes to supported versions of WooCommerce and PHP. the plugin is now more aligned with WooCommerce in terms of supported PHP version (7.0) and a minimum of WooCommerce 4.3 is now required.

    Changelog

    Bug Fixes

    • Use light default background colour for country/state dropdowns. (3189)
    • Fix broken Express Payment Method use in the Checkout block for logged out or incognito users. (3165)
    • Fix State label for Spain. (3147)
    • Don’t throw an error when registering a payment method fails. (3134)

    refactor

    • Use noticeContexts from useEmitResponse instead of hardcoded values. (3161)

  • Edit 2020-09-29: Added one more item to the “Notable fixes and improvements” section that was missed in the original version of this post.

    Beta 1 for the October 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?

    The WooCommerce 4.6 release contains updated versions of WooCommerce Admin (1.6.0) and WooCommerce Blocks (3.4.0), fixes, and localization improvements.

    Notable fixes and improvements

    The main fixes and stability improvements in this release are:

    1. The Home Screen introduced in 4.3 which has previously only been the default for new stores (existing stores had to opt-in), will now be the default for all stores (#5108).
    2. The old setup wizard was removed, and now all new installs will go through the new setup wizard provided by WooCommerce Admin (#26853 and #27047).
    3. Sorting country names now works as expected for languages that use graphic accents (#27416).
    4. Style improvements to the notices when using the Twenty Twenty theme (#27387).
    5. It is now possible to assign to a product a tax class that contains non-ASCII characters (#27615).

    You can find the complete changelog for this release on the changelog.txt file.

    Filters and actions

    We have added new filters and actions:

    FiltersDescription
    woocommerce_return_to_shop_textFilter to change the label of the “Return to shop” button in the empty cart page.
    woocommerce_cart_item_required_stock_is_not_enoughFilter to change the behavior when checking stock for items in the cart.
    woocommerce_should_send_no_stock_notificationFilter to let developers skip the no stock e-mail for certain products.
    woocommerce_after_order_detailsAction to add extra data after the order details section.

    Database changes

    This release does not introduce any changes to the database.

    Release Schedule

    This version of WooCommerce will be released as per this schedule:

    VersionRelease
    BetaSeptember 19, 2020
    Release CandidateSeptember 29, 2020
    4.6 Final ReleaseOctober 13, 2020

    Testing

    As with the previous few releases, we have published testing instructions for 4.6 as well. We’d like to request that everyone help us in testing this release.

    If you discover any bugs during the testing process, please let us know by logging a report in GitHub.

  • There’s a new version of the WooCommerce Blocks plugin. Version 3.4.0 is now available on WordPress.org and GitHub.

    This release is mostly a fix release with a few notable bug fixes and a performance fix.

    Fixed issue with shopper saved payment method overriding default selected new payment method. With this bug if a shopper had a saved card for Stripe but selected a new payment method and left the default selected payment method option (that might not be Stripe depending on what order your store payment methods are configured in), then Stripe would be attempted for making the purchase instead of the payment method selected.

    Fix broken Cart and Checkout Block sidebar layout in some themes. We discovered that some Storefront child themes didn’t define box-sizing: border-box; for some elements, so we implemented a change that helps with more consistent Cart and Checkout display in those themes.

    Improve performance of Checkout block. Some browser environments (in particular Firefox mobile) exhibited significant lag with the checkout block interactions. In this release we implemented some improvements to component structure and implementation that dramatically improves performance.

    Remove hard-coded wp-login.php url. Rather than using a hardcoded path for the login link in the checkout block (when configured to show), we switched to using wp_login_url for generating this link. This exposes a login_url filter for stores that want more control over where shoppers login to the store.

    Fix an issue with COD not showing when first enabled. Some WooCommerce blocks users were sharing with us about not seeing the COD payment method as an option with the blocks when enabled. We finally tracked down why that was happening and fixed in this release.

    More automated tests added. This isn’t reflected in the changelog but I thought it’s worth mentioning that every release we’re increasing our automated test coverage of the blocks and critical flows to help surface problems quicker as we iterate on the blocks.

    Changelog

    Bug Fixes

    • Ensure shopper saved card is used as default payment method (default was being overwritten in some circumstances). (3131)
    • Fix Cart & Checkout sidebar layout broken in some themes. (3111)
    • Fix product reviews schema date fields to use new (WP 5.5) date-time format. (3109)
    • Use wp_login_url instead of hardcoding login path. (3090)
    • Fix an issue with COD not showing when first enabled. (3088)
    • Fix JS console error when COD is enabled and no shipping method is available. (3086)

    performance

    • Create DebouncedValidatedTextInput component. (3108)

    refactor

    • Merge ProductPrice atomic block and component. (3065)

  • This release fixes bugs introduced in WooCommerce 4.4.0 and an issue introduced in WooCommerce 4.5.0.

    In WooCommerce 4.4.0, we introduced functionality that was intended to improve the handling of variable products with the “filter by attribute” widget. (#26260) This pull request caused some additional issues with the handling of attributes that weren’t used with variations, and the count was still incorrect for products that were marked “hidden for catalog”. We’ve decided to roll back the changes to the “filter by attribute” widget and reintroduce them in a future version of WooCommerce. (#27625)

    We’ve also fixed an issue introduced in 4.5.0 which prevented “0” from being used as an attribute value for variations. (#27633)

    Here is the additional changelog for this release:

    * Fix - Revert the changes in filtering by attribute that were introduced in WooCommerce 4.4. #27625
* Fix - Adjusted validation to allow for variations with "0" as an attribute value. #27633

    Thanks to everyone for reporting these issues promptly and helping out with the fix release.

    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 any other issues in the WooCommerce core, please log them in detail on GitHub. Found a security issue? Please submit a report via HackerOne.

  • This release fixes a bug that was introduced with the 4.5.0 release.

    In 4.5.0, if you have “hide shipping costs until an address is entered” enabled in WooCommerce > Settings > Shipping > Shipping options, shipping was neither calculated nor added to the order for countries without a state required in the shipping address. (#27624)

    We’ve fixed the issue and added additional tests to better prevent similar issues from occurring in the future. (#27628)

    We highly recommend upgrading to this version, especially if you have “hide shipping costs until an address is entered” enabled in your settings.

    Here is the additional changelog for this release:

    * Fix - Check for state and postcode fields only if required in `show_shipping`. #27628

    Thanks to everyone for reporting this issue promptly and helping out with the fix release.

    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 any other issues in the WooCommerce core, please log them in detail on GitHub. Found a security issue? Please submit a report via HackerOne.

  • Storefront 2.7.0 has been tagged for release and uploaded to WordPress.org. This is small release.

    Here’s what’s new in 2.7.0 (pulled directly from the changelog):

    • Fix – Respect user-selected Color and Font size values for All Products’ Product Title Block. #1424
    • Fix – Fix issue with draft products showing up in pagination #1452
    • Enhancement – Add icons to notices. #1453

    Download the latest release of Storefront from WordPress.org, or venture over to Dashboard → Updates in your WordPress admin to update your theme.

    As usual, if you see any issues, please log them in detail on Github.

  • We are excited to announce that WooCommerce 4.5 is now publicly available! It has been in development since August 2020 and the core has been updated with about 643 commits from 25 contributors.

    This is a minor release, which means everything is backward compatible with the previous version.

    This release is relatively small compared to recent WooCommerce releases, and is being released with a focus on stability and compatibility. We are currently improving our testing processes based on learnings from recent releases, 4.4 in particular. These changes will allow us to return to our normal release size, and ensure that we are providing a reliable, stable product with each release.

    As always, we recommend creating a backup of your site and making sure that themes and plugins are compatible before updating. You can check out this update guide for more information.

    What’s new in 4.5?

    The WooCommerce 4.5 release contains primarily fixes and improvements.

    New onboarding guide

    welcome-modal

    When you first visit your WooCommerce home screen, you’ll now see a guided tour that provides more information about the home screen. (#4890)

    REST API

    This release merges the REST API (#27100), which was previously a separate repository, back into WooCommerce Core. Any issues with the REST API should now be logged to the Core WooCommerce repository.

    Filters

    We have added new filters:

    FiltersDescription
    woocommerce_cart_product_cannot_add_another_messageFilters message about more than 1 product being added to cart.
    woocommerce_cart_product_out_of_stock_messageFilters message about a product being out of stock.
    woocommerce_cart_product_not_enough_stock_messageFilters message about a product not having enough stock.
    woocommerce_file_download_methodFilter download method.
    woocommerce_query_for_reserved_stockAllows filtering of the query for getting reserved stock of a product.

    Notable fixes and improvements

    There are many fixes and stability improvements in this release, including

    1. When you have “hide shipping costs until an address is entered”, the shipping cost is now hidden until the complete address is entered. This fixes an issue where previously shipping costs were displayed prior to the complete address being entered. (#27143)
    2. If you cancel a pending order, coupon holds for that order are now released. This fixes an issue where cancelling a PayPal checkout caused the coupons that were in the cart to become invalid because they were used in a previous canceled order. (#27179)
    3. When manually creating orders, searches for variations will now fallback to the parent SKU if a child SKU is not specified. (#27171)
    4. Coupon codes are now always stored with HTML entities encoded. This increases security by ensuring that we don’t store unfiltered input. There is a database migration in place when 4.5 is installed, so this is a non-breaking change. (#27140)

    You can find the complete changelog for this release on the changelog.txt file.

    We’ve also made some changes to address issues with the filter by attribute widget when used with variable products in this release, but we recognize that it still may not work as expected. We’re tracking the issues with the widget in #27419 and welcome you follow along there as we work toward fixing this in the next release.

    Database changes

    This release does not require any core database alteration. However, the 4.3 release did introduce a new table, so if you are upgrading from an earlier release than 4.3, make sure that WordPress user has permission to add a new table to the database.

    A re-occurring worker will be scheduled after update to update coupon codes such that HTML entities are properly encoded. This will be done in batches and 10 and is backward compatible.

    Minimum WordPress Requirement

    While this release does not change the minimum PHP version, it does increase the minimum WordPress version to 5.3. Remember that you can read all about the new WordPress support policy in the developer blog post detailing it.

    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

    jonathansadowski claudiosanches Konamiman rrennick kloon ObliviousHarmony
    jonathansadowski claudiosanches Konamiman rrennick kloon ObliviousHarmony
    vedanshujain Aljullu peterfabian juliaamosova tammullen haydenw
    vedanshujain Aljullu peterfabian juliaamosova tammullen haydenw
    Rahmon jgreys georgejipa timmyc thenbrent danielmorell
    Rahmon jgreys georgejipa timmyc thenbrent danielmorell
    IanDelMar
    IanDelMar

    WooCommerce Admin

    jeffstieler samueljseay becdetat joshuatf timmyc psealock
    jeffstieler samueljseay becdetat joshuatf timmyc psealock
    jconroy octaedro c-shultz danielbitzer
    jconroy octaedro c-shultz danielbitzer

    WooCommerce Blocks

    nerrad Aljullu senadir haszari github-actions[bot]
    nerrad Aljullu senadir haszari github-actions[bot]

  • We’ve got a few fixes since last week’s release candidate to include in the release candidate for this week. We are still on track for our planned release next week, on September 8.

    You may have noticed that we didn’t post about release candidate 2. We realized as we were preparing release candidate 2 that we were missing the latest updates from WooCommerce Admin. We caught the issue after publishing the release to GitHub, so we’re releasing release candidate 3, which includes the latest version of WooCommerce Admin.

    Fixes

    • Resolved a Javascript error that occurred when attempting to purchase postage for a completed order. (#5025)
    • Fixed an issue where the filter by attribute widget wasn’t working when the variation had an attribute value of ‘Any’. (#27508)

    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.

    Thanks to all of our testers and contributors!