Changelog

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

  • We’re excited to announce that the release candidate is now available! We are on track for our planned April 13th release date.

    Note that this is a minor release focusing on bug fixes and performance improvements.

    Changes

    • WooCommerce Admin package has also been updated to 2.1.4 with this release of WooCommerce. This new package adds New Zealand and Ireland to selective bundle option.
    • Fix – The count of completed steps for the onboarding wizard in the dashboard widget was incorrect. #29518
    • Dev – Fixes in the REST API endpoint for adding/updating the coupons of an existing order. #29474

    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 5.2 is now available for beta testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.

    What’s new?

    This is a minor release focusing on bug fixes and performance improvements. Just like other minor releases, this release also aims to be backward compatible with previous WooCommerce releases.

    Highlights

    1. WooCommerce Blocks 4.7: Blocks package have been updated to 4.7. Please take a look at the release posts for 4.7, 4.6, 4.5.2 and 4.5.1 to see what’s new and improved.
    2. WooCommerce Admin 2.1.3: WooCommerce Admin package has also been updated to 2.1.3 with this release of WooCommerce. This new package contains lots of bug fixes and stability improvements, see the changelog for details on what’s new in this version (and also on previous versions up to 2.0.2)
    3. Country code verification on checkout: Now it won’t be possible to perform a successful checkout when submitting an invalid country code. #28849
    4. Low stock threshold for variations: The stock amount that triggers a low stock warning email can now be properly configured for individual variations on variable products. #29345
    5. Dropdowns fix: With the updated version of jQuery on the newest WordPress some dropdowns (e.g. product attributes filter) became unusable, it’s fixed now. #29397
    6. Product categories widget item count fix: The items count in the product categories widget item count not always showing the correct number, it’s fixed now. Also, a new hook has been added to disable the recounting of items. #29281
    7. New shop setup widget: A new “WooCommerce Setup” widget is added to promote users to finish the onboarding tasks, it shows only when there are unfinished tasks. #29174
    8. Updated net sales link: The “net sales” link in the dashboard now points to the new analytics screen when WooCommerce Admin is enabled. #29149
    9. Improved handling of downloadable file paths: Strip /// sequences in downloadable file paths to prevent access to absolute paths. #28699
    10. REST API: Add support for “order” and “class” types for shipping method zones: The shipping method zone endpoint wasn’t accepting settings of these types, it’s fixed now. #29218
    11. REST API: Fix wrong taxonomy caching in term and product attributes controllers: The taxonomy from the first request was being reused in further requests when those were performed programmatically. #29115
    12. REST API: Make the refunds creation endpoint accept input as documented: The input for the endpoint accepts now the input as described in the documentation (no breaking changes introduced). #29099

    Filters and actions

    We have added two new filters in this release.

    FilterDescription
    woocommerce_product_recount_termsFilter to allow/prevent recounting of terms as it could be expensive, e.g. when bulk importing products. #29281

    woocommerce_ajax_order_items_removedAction that fires after order items are removed. #29241
    5.2 new filter hooks

    Database Changes

    This release does not introduce any database changes.

    Template changes

    This release does not introduce any changes to templates.

    Release Schedule

    This version of WooCommerce is scheduled to be released as follows:

    VersionRelease
    BetaMarch 23th, 2021
    Release CandidateMarch 30th, 2021
    5.2 Final ReleaseApril 13th, 2021
    Release schedule for 5.2

    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.

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

    This release introduces: Several fixes around payment gateway display and extensibility interface, more stability around payment methods, styling fixes, and general fixes, check the changelog below for more information.

    Dev note

    A new configuration property is available to registered payment methods for additional handling of saved payment method tokens. See the updated payment method integration docs for details.

    For Payment Method integrations with Block Checkout, the canPayArgument now includes billingData. This consists of the customer billing address, email, and phone number, so you can disable or enable a payment method conditionally based on those properties.

    Changelog

    Enhancements

    • A new configuration property is available to registered payment methods for additional logic handling of saved payment method tokens. (3961)
    • Provided billing data to payment method extensions so they can decide if payment is possible. (3922)
    • Prevent errant payment methods from keeping Cart and Checkout blocks from loading. (3920)
    • Fix block elements that don’t play well with dark backgrounds. (3887)

    Bug Fixes

    • Remove extra padding from payment methods with no description. (3952)
    • Fix "save payment" checkbox not showing for payment methods. (3950)
    • Fix cart preview when shipping rates are set to be hidden until an address is entered. (3946)
    • Sync cart item quantity if its Implicitly changed. (3907)
    • Fix FSE not being visible when WC Blocks was enabled. (3898)
    • Ensure sale badges have a uniform height in the Cart block. (3897)

  • We’re excited to announce that WooCommerce 5.1 is now released! This is the third minor release of 2021 and has

    1. 279 commits from 37 contributors in WooCommerce core.
    2. 109 commits from 22 contributors in the WooCommerce Admin package.
    3. 175 commits from 18 contributors in the WooCommerce Gutenberg Products Block package.

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

    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 5.1?

    1. WooCommerce Blocks 4.4: Blocks package have been updated to 4.4.3. Please take a look at the release post to see what’s new and improved.
    2. WooCommerce Admin 2.0.2: WooCommerce Admin package has also been updated to 2.0.2 with this release of WooCommerce. This new package contains lots of bug fixes and stability improvements. Changes can be found here.

    Notable fixes and improvements

    1. jQuery 3 deprecated items: This will be an ongoing effort to fully remove all deprecated jQuery 3 items from core. #28753
    2. Updating order tax: Previously after recalculating totals when tax setting has changed (such as name and/or rate), the tax name does not update in the order meta. This has been fixed. #28983
    3. Notices not going away: Previously when trying to close an admin notice such as the “Database has been updated” notice, this notice keeps reappearing. This has been fixed. #28500

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

    Filters and actions

    We have added two new filters in this release.

    FilterDescription
    woocommerce_exporter_product_typesFilter to allow third-parties to filter the exportable product types. #28950
    woocommerce_cancel_unpaid_orders_interval_minutesFilter to change the interval minutes for holding stock on cancel/unpaid orders. #28933

    5.1 new filter hooks

    Database Changes

    This release does not introduce any database changes.

    Template changes

    This release does not introduce any changes to templates.

    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

    claudiosanches zhongruige roykho rrennick vedanshujain barryhughes
    claudiosanches zhongruige roykho rrennick vedanshujain barryhughes
    Konamiman tammullen louwie17 peterfabian artpi mikejolley
    Konamiman tammullen louwie17 peterfabian artpi mikejolley
    veljkho chickenn00dle moon0326 mattsherman ObliviousHarmony jonathansadowski
    veljkho chickenn00dle moon0326 mattsherman ObliviousHarmony jonathansadowski
    psealock Marcuzz octaedro nielslange
    psealock Marcuzz octaedro nielslange

    WooCommerce Admin

    joshuatf samueljseay psealock hsingyuc louwie17 adrianduffell
    joshuatf samueljseay psealock hsingyuc louwie17 adrianduffell
    becdetat joelclimbsthings elizaan36 octaedro timmyc szepeviktor
    becdetat joelclimbsthings elizaan36 octaedro timmyc szepeviktor
    chickenn00dle ilyasfoo LevinMedia jorgeatorres tomalec ribaricplusplus
    chickenn00dle ilyasfoo LevinMedia jorgeatorres tomalec ribaricplusplus
    mattsherman nerrad moon0326
    mattsherman nerrad moon0326

    WooCommerce Blocks

    opr mikejolley Aljullu nerrad senadir ralucaStan
    opr mikejolley Aljullu nerrad senadir ralucaStan
    budzanowski
    budzanowski

    Action Scheduler

    barryhughes claudiosanches
    barryhughes claudiosanches

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

    This release contains mostly bugfixes, some technical debt pay down, and a few changes to better support extensibility.

    Fixes include respecting out of stock visibility setting in the All Products block, hiding the “browse shop” link in the cart block empty state when there is no shop page set, and some updating of styles for various contexts. There’s also an important fix related to the application of a coupon appearing to change the total value for items listed with the cart block.

    Dev Note

    An important note that internally, this release has modified how Automattic\WooCommerce\Blocks\BlockTypes\AbstractBlock (the base class for all of our blocks) functions, and how it loads assets. AbstractBlock is internal to this project and does not seem like something that would ever need to be extended by 3rd parties, but if you are doing so for whatever reason, your implementation would need to be updated to match. (3829)

    Changelog

    Bug Fixes

    • Handle out-of-stock product visibility setting in All Products block. (3859)
    • Show cart item subtotal instead of total in Cart and Checkout blocks (#3905)
    • Fix button styles in Twenty Nineteen theme. (3862)
    • Return correct sale/regular prices for variable products in the Store API. (3854)
    • Remove shadows from text buttons and gradient background from selects in some themes. (3846)
    • Hide Browse Shop link in cart block empty state when there is no shop page. (3845)

    Various

    • StoreAPI: Inject Order and Cart Controllers into Routes. (3871)
    • Update Panel component class names to follow guidelines. More info can be found in our theming docs. (3860)
    • Refactor block type registration to support 3rd party integrations.

  • We’re excited to announce that the release candidate is now available! We are on track for our planned March 9th release date.

    Note that this is a minor release focusing on bug fixes and performance improvements.

    Changes

    • Fix – Placeholder image height in cart. #29139
    • Dev – “Store management insights” option now is turned off by default. #29105

    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.

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

    This release includes a bug fix which ensures the prices of items in the Cart block display correctly if the store is configured to display prices without decimal places.

    Alongside this bug fix, we also included an update to styling in the Cart block that will ensure the product sale badge correctly displays below the product total price.

    Changelog

    Bug Fixes

    • Fix cart items showing a price of 0 when currency format didn’t have decimals. (3876)
    • Ensure the sale badge is displayed correctly below short prices in the Cart block. (3879)

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

    This release includes a new look for the payment methods section of the Checkout block, a new look for items in the Cart block and some design tweaks to how data is displayed in the Cart and Checkout blocks’ sidebars. The “Place order” button is correctly aligned in the Checkout block now, too!

    Old payment method design

    New payment method design

    We also made changes to the way errors are reported when something goes wrong during checkout relating to stock availability or coupon validity. These errors now explain the problem, which will help the customer to understand why their checkout failed, and what they can do to fix it.

    Another change we made was to the way links to the “Terms and Conditions” and “Privacy Policy” pages are handled, they will now be hidden if the respective page becomes unpublished.

    This release also fixes:

    • a bug where tax would not be calculated properly in the Cart and Checkout blocks
    • a bug where special characters would not render correctly in the Cart sidebar, and
    • a bug where a warning would be displayed if two different items in the Cart had the same name.

    Changelog

    Bug Fixes

    • Fix JS warning if two cart products share the same name. (3814)
    • Align place order button to the right of the block. (3803)
    • Ensure special characters are displayed properly in the Cart sidebar. (3721)
    • Fix a bug where the total price of items did not include tax in the cart and checkout blocks. (3851)

    Enhancements

    • Login links on the checkout should use the account page. (3844)
    • Prevent checkout linking to trashed terms and policy pages. (3843)
    • Improved nonce logic by moving nonces to cart routes only. (3812)
    • If coupons become invalid between applying to a cart and checking out, show the user a notice when the order is placed. (3810)
    • Improve design of cart and checkout sidebars. (3797)
    • Improve error displayed to customers when an item’s stock status changes during checkout. (3703)
    • Dev – Block Checkout will now respect custom address locales and custom country states via core filter hooks. (3662)
    • Update checkout block payment methods UI. (3439)

  • WooCommerce 5.1 is now available for beta testing! You can either download it directly from WordPress.org or install our WooCommerce Beta Tester Plugin.

    What’s new?

    This is a minor release focusing on bug fixes and performance improvements. Just like other minor releases, this release also aims to be backward compatible with previous WooCommerce releases.

    Highlights

    1. WooCommerce Blocks 4.4: Blocks package have been updated to 4.4.3. Please take a look at the release post to see what’s new and improved.
    2. WooCommerce Admin 2.0: WooCommerce Admin package has also been updated to 2.0.1 with this release of WooCommerce. This new package contains lots of bug fixes and stability improvements.
    3. jQuery 3 deprecated items: This will be an ongoing effort to fully remove all deprecated jQuery 3 items from core. #28753
    4. Updating order tax: Previously after recalculating totals when tax setting has changed (such as name and/or rate), the tax name does not update in the order meta. This has been fixed. #28983
    5. Notices not going away: Previously when trying to close an admin notice such as the “Database has been updated” notice, this notice keeps reappearing. This has been fixed. #28500

    Filters and actions

    We have added two new filters in this release.

    FilterDescription
    woocommerce_exporter_product_typesFilter to allow third-parties to filter the exportable product types. #28950

    woocommerce_cancel_unpaid_orders_interval_minutesFilter to change the interval minutes for holding stock on cancel/unpaid orders. #28933
    5.1 new filter hooks

    Database Changes

    This release does not introduce any database changes.

    Template changes

    This release does not introduce any changes to templates.

    Release Schedule

    This version of WooCommerce is scheduled to be released as follows:

    VersionRelease
    BetaFebruary 16th, 2021
    Release CandidateFebruary 23th, 2021
    5.1 Final ReleaseMarch 9th, 2021
    Release schedule for 5.1

    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.

  • We’re excited to announce that WooCommerce 5.0 is now released! This is the second minor release of 2021 and has

    1. 255 commits from 30 contributors in WooCommerce core.
    2. 163 commits from 26 contributors in the WooCommerce admin package.

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

    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 5.0?

    Versioning

    Previous to this release, we’ve partially followed the Semantic Versioning (Semver) schema. Going forward we’ve decided to follow the WordPress versioning schema. This means that although we’re releasing version 5.0 (which usually means a backwards compatible breaking release under Semver), we will maintain backwards compatibility.

    See more details in Developer Advisory: Changes to WooCommerce Versioning Scheme.

    WooCommerce Admin 1.9.0

    This release updates the WooCommerce admin package to 1.9.0 from 1.8.3. Mostly bugfixes and improvements are included in this update, including:

    • Help tooltip will now appear when a task has not been completed the second time to give additional help for the merchant. (#5826)
    • Home screen task extensibility. Allows 3pd to add their own tasks. (#5794).
    • Added “unread” indicator to inbox messages. This helps to quickly see which inbox messages have not been read. (#6047)

    Notable fixes and improvements

    1. Product Review Count: Previously in 4.9, we fixed the product review count from this PR #28624. This worked for all new comments being created however it did not correctly fix the issue that already happened. So we’ve put in a migration script which will fix the review count when new reviews are added. #28814
    2. Deprecate legacy reports: Since WooCommerce 4.0, it has added a new and improved WooCommerce Analytics. We’re encouraging users to start using the new WooCommerce Analytics and thus we have soft deprecated the legacy reports with a notice in the legacy reports section. #28799
    3. CSS Variables: We’ve added WooCommerce prefixed CSS variables to the stylesheet. This provides easier extendibility when developers need to utilize the same WooCommerce default styling without needing to recreate the CSS. #28709
    4. Restoring products, orders and coupons: Previously after trashing orders, products or coupons — when restoring, it puts these items into “draft” status. Now it will restore to the same status as what it was before to prevent issue. #28690
    5. Changing product type with attached files: Previously when an order is placed with a product that had downloadable files and when you change the product type to say a variable product, the permission for the downloadable files would be lost and access would be denied. This has been fixed so that it now recognizes the change of product type and when you go to use the same downloadable file, it would recognize it and recreate the permissions for the same customer. #28521

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

    Database Changes

    While there are no schema changes to the database tables, we want to highlight that there will be a script that runs in the database that fixes any potential issues with the product review counts. #28814. This in turn will bump the database version to 5.0.0.

    Template Changes

    This release does not introduce any changes to template files.

    Filters and actions

    We have added one new action in this release.

    ActionDescription
    woocommerce_activated_pluginAction to signal that packages such as WC Admin has been activated. #28698
    5.0 new action hooks

    We have added two new filters in this release.

    FilterDescription
    woocommerce_delete_variations_on_product_type_changeFilter to prevent
    variations from being deleted while switching from a variable product type to a variable product type. #27137

    woocommerce_new_order_email_allows_resendFilter to allow resending of the new order email to the admin. #28858
    5.0 new filter hooks

    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

    claudiosanches roykho rrennick vedanshujain Konamiman veljkho
    claudiosanches roykho rrennick vedanshujain Konamiman veljkho
    peterfabian helgatheviking jonathansadowski zhongruige mfs-mindsize menakas
    peterfabian helgatheviking jonathansadowski zhongruige mfs-mindsize menakas
    lsinger ObliviousHarmony Dan-Q psealock Aljullu budzanowski
    lsinger ObliviousHarmony Dan-Q psealock Aljullu budzanowski
    stevegrunwell JoseeWouters sc0ttkclark jahir07 mehrshaddarzi paulochang
    stevegrunwell JoseeWouters sc0ttkclark jahir07 mehrshaddarzi paulochang
    jffng kevinruscoe raicem ilyasfoo
    jffng kevinruscoe raicem ilyasfoo

    WooCommerce Admin

    samueljseay joshuatf joelclimbsthings louwie17 octaedro moon0326
    samueljseay joshuatf joelclimbsthings louwie17 octaedro moon0326
    hsingyuc psealock adrianduffell ilyasfoo becdetat johndcoy
    hsingyuc psealock adrianduffell ilyasfoo becdetat johndcoy
    ribaricplusplus nerrad manjeet-wisetr tomalec
    ribaricplusplus nerrad manjeet-wisetr tomalec