Changelog

  • WooCommerce 8.2.2 is now available for download.

    What’s new?

    • We fixed a bug introduced with the WordPress 6.4 release which breaks sites using the Classic Template block for the Single Product template. #41291

    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.


  • We released an update to WooCommerce Blocks: version 11.5.1. It is now available for download on WordPress.org and GitHub.

    Changelog

    Bug Fixes

    • WordPress 6.4: fixed a bug which would break sites using the Classic Template block for the Single Product template. (11455)
    • Fixed an error that might appear when the pre_get_block_template filter is called with wrong parameters. (11690)

  • RC 1 for the November 14 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 8.3.0 Beta 1, the following changes have been made:

    • The experimental email opt-in field from the Core Profiler has been improved to perform better email validation. #41152
    • Jetpack data is now preloaded even without the Jetpack plugin installed. #41092
    • A banner image was optimized to reduce the WooCommerce package size. #41247

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

    Release Schedule

    We’re on track for our planned November 14 release.

    VersionRelease
    Final ReleaseNovember 14, 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.

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

    This version introduces fixes and improves across product block patterns and template parts. The full changelog can be found below, but some notable improvements are as follows.

    Components available via blocksComponents

    The SortSelect, Textarea, and Title components have been moved to the wc.blocksComponents package. This initiative allows developers to avoid duplicating efforts and directly access necessary components for their projects. More details can be found in the respective pull requests:

    Cart and Checkout Template Enhancements

    • Semantic Checkout Header: The checkout header now uses the <header> element to improve semantic understanding and accessibility, aligning with standard HTML practices. (11222)
    • Interactive Cart Feedback: The “Remove Item” link in the Cart block now has a hover state, providing immediate visual feedback for interaction. (11526)

    Changelog

    Enhancements

    • Add margin bottom to the Hero Product 3 Split pattern. (11573)
    • Set explicit margins in the search bar group on the Large Header pattern. (11571)
    • Add aspect ratio to the Featured Products 5 Columns pattern. (11570)
    • Fix Product Collection 4 Columns pattern button height. (11553)
    • Change the “chessboard” pattern structure to improve mobile view. (11545)
    • Footer with 3 menus pattern: Update the spacing in the columns to improve the mobile view. (11544)
    • Add checkout-header template to the correct area in site editor. (11528)
    • Product gallery/add crop images. (11482)
    • Remove authors filter from Product Collection block. (11427)
    • Move SortSelect to components package. (11411)
    • Move Textarea to components package. (11384)
    • Move Title to components package. (11383)
    • Use the element for the checkout header. (11222)
    • Product Gallery Thumbnails: Add View all overlay. (11087)

    Bug Fixes

    • Fix Hero Product 3 Split pattern text content. (11612)
    • Prevent theme button border appearing in opinionated patterns. (11564)
    • Prevent Sale badge overflowing the Product Image in some product grid blocks. (11556)
    • Block Checkout: Add back missing render-checkout-form hook. (11554)
    • Ensure that the “Remove Item” link on Cart block has a hover state. (11526)
    • All Products: Add cursor pointer when hovering over pagination items. (11502)
    • Product Collection: Fix the PHP Warning after migrating from Products (Beta). (11494)
    • Footer with 2 Menus Dark pattern: Fix the Site Title color contrast in TT4. (11484)
    • Essential Header Dark pattern: Fix color contrast issues in TT4. (11480)
    • Display shipping calculator link for guests shopper. (11442)
    • Comboboxes should match against values before looking at labels. (11410)
    • Fix products incorrectly marked as discounted. (11386)
    • Ensure input is validated when autofilled in Firefox. (11062)
    • Remove bullet points and unnecessary padding from SearchListControl. (11444)

  • Beta 1 for the November 14 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 8.2.0, the following changes have been made:

    • WooCommerce Blocks has been updated to 11.4.2. See the release notes for 11.4.0 for changes. #41050
    • Improvements to the mobile app onboarding experience. #40559
    • Marketplace search improvements #40667
    • Cart and Checkout Blocks is now the default experience on new WooCommerce installations #40867

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

    Release Schedule

    We’re on track for our planned November 14 release.

    VersionRelease
    Release CandidateNovember 7, 2023
    Final ReleaseNovember 14, 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.

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

    The 11.4.0 release was published with incomplete package issues. Version 11.4.1 addressed this problem.

    Bug Fixes

    • Regenerate package.

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

    Notable Changes

    Checkout styling consistency updates

    We’ve worked on some consistency updates to the default styling of the checkout blocks; notably applying consistent border radius to components, more balanced spacing, and improved focus styles.

    Increased the number of visible products when cart is empty

    The empty cart views now default to showing 4 new products rather than 3. This is still customisable in the editor if you wish to increase, decrease, or hide these products.

    Cart and Checkout block transforms for classic shortcodes

    To make it easier to toggle between classic cart and checkout shortcodes, and the new blocks, we’ve added some new transforms in the editor. If the blocks detect an incompatible extension you’ll be able to switch back to the classic shortcodes with one click via the block inspector:

    You’ll also be able to switch to the classic blocks using block transforms:

    Switching back from classic shortcode to blocks is also easy using the “transform into blocks” option. This should offer merchants more flexibility and easier editing when setting up shop.

    Dev Notes

    Store API: Product Attribute Terms route sorting options

    The Store API /products/attributes/<id>/terms route now has an additional sorting option: menu_order. This allows terms to be returned in the order the merchant sorts them via WP Admin.

    e.g. GET https://example-store.com/wp-json/wc/store/v1/products/attributes/1/terms?orderby=menu_order.

    Exporting shared components

    A bunch of cart and checkout components, including FormStep, Spinner, RadioControl, FormattedMonetaryAmount, Chip, CheckboxList, have been moved to a separate package for consumption. We’ll be sharing a post on the dev blog about this later in the week with instructions on how to utilise these components.

    Cart block level shipping options have moved

    The cart block previously had the same option as WooCommerce core to “enable the shipping” calculator at block level, however, this was causing confusion because it wasn’t clear which option (block or global) would take priority, and whether the block level option would impact other views.

    To fix this, we’ve removed the block level option. Now in order to enable or disable the shipping calculator you must use the global setting under WooCommerce > Settings > Shipping > Shipping Options labelled Enable the shipping calculator on the cart page.

    Unfortunately due to this change, if you did have a scenario where you had it enabled at block level, but disabled in the settings, your calculator will be hidden until you toggle the option back on in settings. Note, that this will not affect the calculation of shipping during checkout.

    Changelog

    Enhancements

    • Store Customization: Update the “Large Footer” pattern. (11381)
    • Store Customization: Update the Footer with 3 Menus pattern. (11356)
    • Store Customization: Update the Social pattern. (11355)
    • Store Customization: Re-enable the Product Hero 2 Column 2 Row pattern. (11346)
    • Product Collection: Shrink columns to fit. (11320)
    • Store Customization: Adjust margins and paddings for the Featured Category Triple. (11319)
    • Move Spinner to components package. (11317)
    • Store Customization: Fix “Discount Banner” pattern. (11315)
    • Move RadioControland RadioControlAccordion components to components package. (11312)
    • Store Customization: Fix the “Testimonials 3 Columns” title alignment. (11281)
    • Store Customization: Fix pattern spacing in homepage template 3. (11279)
    • Store Customization: Fix pattern spacing in homepage template 2. (11278)
    • Store Customization: Fix pattern spacing in homepage template 1. (11268)
    • Store Customization: Remove placeholder text from the image on the Hero Product Chessboard pattern. (11250)
    • Move FormStep to the components package. (11246)
    • Temporarily disable the woocommerce-blocks/product-hero-2-col-2-row pattern. (11234)
    • Add: menu-order orderby option for Product Attribute Terms route. (11232)
    • Move FormattedMonetaryAmount to the components package. (11230)
    • Cart and Checkout block transforms for classic shortcodes. (11228)
    • Use the <main> tag in Cart and Checkout templates. (11224)
    • Move Chip and RemovableChip to components package. (11223)
    • Move CheckboxList and create new blocksComponents package. (11214)
    • Store Customization MVP: Add fallbacks to all the pattern titles, descriptions, and buttons. (11208)
    • Checkout Field Padding and Spacing. (11207)
    • Make patterns full width and fix margin. (11206)
    • Product Collection 5 Columns pattern: Update title and price to be rows instead of columns. (11205)
    • Product Collection: Featured Products 5 Columns: Remove no results block. (11198)
    • Add universal border radius for form elements and components. (11193)
    • Update wording on checkout error message to try to prevent retries. (10888)

    Bug Fixes

    • Remove hardcoded queryIds from patterns that include Product Collection. (11290)
    • Fix: Mini-Cart block shows wrong total if there are multiple installs on the same domain. (11257)
    • Fix inconsistent border focus styles. (11203)
    • Product Gallery pattern: Use the Product Collection block. (11194)
    • Increase number of visible products when cart is empty. (11182)
    • Fix a bug in which shipping phone field was not being synced to the billing field. (10603)
    • Always show the Enable the shipping calculator on the cart page option. (11421)

    Documentation

    • Add order and checkout order endpoint documentation. (11157)

    Various

    • Add Local Pickup event and Cart/Checkout page views events. (11225)

  • We’re announcing an important update regarding Action Scheduler — the scalable job queue for processing large queues of tasks in the background in WordPress. In our ongoing commitment to keeping Action Scheduler reliable and efficient, we are officially adopting an “L-2” dependency version policy.

    This policy will be effective starting with the next release of Action Scheduler.

    What is the “L-2” Policy?

    The “L-2” policy, short for “Latest Minus Two,” means that Action Scheduler will support:

    • The latest version of WordPress, the version before that, and the version before that.
    • The latter version’s minimum PHP version.

    For example, at the time of writing, the latest WordPress version is 6.3. The “minus two” version is WordPress 6.1, which requires PHP 5.6 or later. Action Scheduler would therefore require WordPress 6.1 or later and PHP 5.6 or later. Please also see this overview of which WordPress versions work with what PHP versions.

    This policy ensures that Action Scheduler and plugins that depend on it remain compatible with a wide range of WordPress installations while keeping up with the latest advancements in the WordPress and PHP ecosystems.

    Why Adopt “L-2”?

    By implementing the “L-2” policy, we aim to strike a balance between supporting the latest WordPress features and providing stability for users with slightly older WordPress installations. Here’s why this policy is beneficial:

    • Reliability: as Action Scheduler drops support for outdated versions, we can simplify its code and as a result decrease the probability for bugs.
    • Modern Features: with the adoption of this policy, Action Scheduler now has a defined path towards being able to use modern APIs provided by both WordPress and PHP.
    • Security: Keeping up with updates to WordPress and PHP helps maintain the security of Action Scheduler as well as your site or plugin.

    What Action Should I Take?

    As a consequence of this new policy, the next version of Action Scheduler will require WordPress 6.2 or later as well as PHP 5.6 or later.

    If you are a user of WooCommerce or WordPress, it is always a good idea to update them regularly. The same is true for the PHP version installed on your server and any plugins or extensions you might be using. If you’re following this advice there’s nothing else you need to do to ensure you’ll continue to have access to the latest Action Scheduler features.

    If you are the developer of a WordPress plugin that depends on Action Scheduler, we recommend that you adopt a similar policy. This ensures that your plugin will be able to benefit from any and all updates to Action Scheduler. If this is not an option in your specific situation, you are free to continue using the latest version of Action Scheduler that is compatible with your extension. Note that this means your users might miss out on important bug fixes, however.

    We understand that every WordPress project is unique, and our goal is to make Action Scheduler as versatile and dependable as possible. For more information, updates, and documentation, please visit our official Action Scheduler repository on GitHub.

    If you have any questions or need assistance, feel free to reach out to the friendly WooCommerce community on Slack or leave a comment here.


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

    Notable Changes

    We’ve fixed a regression where merchants adding a new “All Products” block would see an error on the frontend page preventing the block from displaying correctly.

    Changelog

    Bug Fixes


  • WooCommerce 8.2.1 is now available for download.

    What’s new?

    • We’ve rolled back a change introduced in 8.2.0 that automatically selected all global attribute terms when adding a global attribute to a product. #40729

    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.