WooCommerce Blocks


WooCommerce Blocks are the easiest, most flexible way to display your products on posts and pages!

For more information on what blocks are available, and how to use them, check out the official documentation.

Note: Feature plugin for WooCommerce + Gutenberg. This plugin serves as a space to iterate and explore new Blocks and updates to existing blocks for WooCommerce, and how WooCommerce might work with the block editor.

Use this plugin if you want access to the bleeding edge of available blocks for WooCommerce. However, stable blocks are bundled into WooCommerce, and can be added from the “WooCommerce” section in the block inserter.

  • Active Filters
  • All Products
  • All Reviews
  • Best Selling Products
  • Cart including Cross-Sells
  • Checkout
  • Featured Category
  • Featured Product
  • Filter by Attribute
  • Filter by Price
  • Filter by Rating
  • Filter by Stock
  • Hand-picked Products
  • Mini-Cart
  • Newest Products
  • On Sale Products
  • Product Categories List
  • Product Search
  • Products by Attribute
  • Products by Category
  • Products by Tag
  • Reviews by Category
  • Reviews by Product
  • Top Rated Products
  • Customer Account

Getting Started

Minimum Requirements

  • Latest release versions of WordPress and WooCommerce (read more here)
  • PHP version 7.3 or greater (PHP 7.4 or greater is recommended)
  • MySQL version 5.6 or greater

Visit the WooCommerce server requirements documentation for a detailed list of server requirements.

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of this plugin, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

In the search field type “WooCommerce Blocks” and click Search Plugins. Once you’ve found this plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.

Manual installation

The manual installation method involves downloading the plugin and uploading it to your webserver via your favourite FTP application. The WordPress codex contains instructions on how to do this here.

Sample data

WooCommerce comes with some sample data you can use to populate the products and get started building Products blocks quickly and easily. You can use the core CSV importer or our CSV Import Suite plugin to import sample_products.csv.

Where can I report bugs or contribute to the project?

Bugs should be reported in the WooCommerce Blocks GitHub repository.

This is awesome! Can I contribute?

Yes you can! Join in on our GitHub repository 🙂

Release and roadmap notes available on the WooCommerce Developers Blog


این افزونه 2 بلوک ارائه می‌دهد.

  • Filter by Stock Controls Enable customers to filter the product grid by stock status.
  • Filter by Rating Controls Enable customers to filter the product grid by rating.

نقد و بررسی‌ها

جولای 19, 2023 1 پاسخ
I've attempted to use this cart / checkout solution for over a year on multiple Woo stores. Every time they update the plugin they break cart and checkout and I start getting customer service emails about the site not working. I look like an ass to my clients and lose business. This solution is a shameful embarrassment. The legacy cart works fine, it's just not worth the short term presentation upgrade for the headache this plugin will add to your life. I'm a Gutenberg person too, but this stuff just don't work.
جولای 7, 2023 3 پاسخ
This plugin deactivates your theme styles. I couldn't find a solution how to disable plugin styles. Standard methods for woocommerce doesn't work. UPD. I tested the plugin one more time. In terms of functionality - it is good and usefull. But styling takes a lot of time and effort. You have to rewrite all the styles. I couldn't find a solution how to deactivate WC Block styles.
خواندن تمامی 91 نقد و بررسی‌

توسعه دهندگان و همکاران

“WooCommerce Blocks” به 23 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.

ترجمه “WooCommerce Blocks” به زبان شما.

علاقه‌ مند به توسعه هستید؟

کد را مرور کنید, را بررسی کنید مخزن SVN, یا مشترک شوید گزارش توسعه توسط RSS.

گزارش تغییرات

11.7.0 – 2023-12-05


  • The Block Hooks API is implemented to auto-inject the Mini-Cart block in header patterns and template parts when the “Twenty Twenty-Four” theme is active. The Mini-Cart block also now defaults to not show the total for the items in the cart when inserted into content. (11745)
  • Decrease modal width. (12003)
  • [Store Customization] Update the default content in patterns. (11997)
  • [Store Customization] Update the “Footer with 3 Menus” pattern to remove the last 2 menus. (11980)
  • Limit number of visible incompatible extensions in sidebar notice. (11972)
  • Improve readability of order note. (11944)
  • Reorganise Columns controls and fix undefined problem in Product Collection settings. (11937)
  • Switch to NoticeBanner component inside Store Notices Block placeholder. (11920)
  • Preserve shrinkColumns value when switching the layout type of Product Collection. (11905)
  • Tweak the product prompt. (11903)
  • Add DELETE private/ai/pattern endpoint. (11890)
  • Update notice for default cart and checkout. (11861)
  • Enable shrink columns option in Product Collection by default. (11821)
  • Move Combobox to components package. (11353)
  • Interactivity API: Implement the new store() API. (11071)

Bug Fixes

  • [CYS] Fix regression and ensure AI-generated content is assigned to products after the third attempt. (12016)
  • [Product Collection] Fix: HTML Entity Decoding in Taxonomy Controls. (11982)
  • Product Gallery: Add a Product Image fallback. (11978)
  • Reviews by Product: Fix reviews count not appearing in product selector. (11976)
  • Hook woocommerce_single_product_summary action to core/post-excerpt block. (11953)
  • fix: Store notices always shows as an error type #11768. (11932)
  • [Product Collection] Fix: HTML entity decoding for product names in Hand-Picked Products. (11927)
  • Validate coupon usage against customer id AND emails. (11860)
  • Pass order ID to woocommerce_before_thankyou hook. (11852)
  • Translate the prefixes passed to post-terms in product-meta. (11811)
  • Prevent fatal errors when using Cart Tokens and creating new accounts on checkout. (11785)
  • Product Gallery Thumbnails: Add support for cropping. (11718)
  • Fix: Product Collection show products with correct stock statuses. (11708)
  • Product Gallery Thumbnails: Fix overflow issues and improve responsiveness. (11665)


  • Update extensibility doc. (11924)
  • Move CheckboxControl to components package and leave alias in checkout package. (11662)

11.6.2 – 2023-12-04


  • Update the “Give us your feedback” link to point to the WooCommerce repo discussions. #11999 #12006

11.6.1 – 2023-11-23

Bug Fixes

  • Add missing woocommerce classname to Classic Cart/Checkout Blocks container so UI updates when the cart is emptied. #11919
  • Fix an issue that caused the Order by select in Reviews blocks to always be disabled. #11918
  • Fix All Reviews, Reviews by Product and Reviews by Category blocks not being rendered. #11913

11.6.0 – 2023-11-22


  • Product Collection – New ‘No Results’ block with default UI. #11783
  • We have moved the TotalsItem, TotalsFees, Subtotal, Banner, StoreNotice, StoreNotices, Panel, TextInput, ValidatedTextInput and ValidationInputError components to the @woocommerce/blocks-components package. Previously these were available in @woocommerce/blocks-checkout . Your code will continue to work as we have added aliases to the new location. Despite this, it is recommended that you change your code to import this component from @woocommerce/blocks-components as the import from the checkout package will be deprecated in the future. #11766 #11698 #11654 #11773
  • Improve performance in patterns registration. #11733
  • Patterns: remove unused author, sticky, and parents attributes from the Product Collection block in patterns. #11673
  • Semantic enhancement to the position of a phone field in Checkout. #11651
  • Migrate the Product Button to the new store() API of the Interactivity API.. #11558
  • Product Collection: Add support for filtering products by featured status. #11522

Bug Fixes

  • Make “Use same address for billing” visible by default. #11804
  • Fix the order endpoint tax line items format. #11796
  • Store API/Blocks Extensibility: Fix recursive extension schema validation. #11792
  • Fix: Left align local pickup address. #11772
  • Fix typo in classic checkout modal. #11771
  • Fix hardcoded shop link in “Hero Product 3 Split” pattern. #11767
  • Fix billing address condensed address state in the editor and in Firefox. #11765
  • Related Products: Make the heading translated when in blockified Single Product template. #11693
  • Add to Cart with Options block: fix inconsistency between editor and frontend styles. #11614
  • Product Button: Improve the width and padding. #11537
  • Fix the Layout for Shipping and Billing Address Forms in the Checkout Block #11486
  • Minor fixes for PHP 8. #11473
  • Product Button: always enqueue the store. #11858
  • Fixed params passed to woocommerce_before_thankyou for block checkout. This should be an order ID, not an order object. #11862
  • Enhanced validation for limited use coupons and guest users. #11860


  • Updated documentation for the onProcessingSetup observer. #11751

11.5.4 – 2023-11-13

Bug Fixes

  • Prevent PHP warnings when using Jetpack WooCommerce Analytics module. #11707
  • Fixed address components in Firefox, and editing of address form in the editor. #11714
  • Fix Classic Cart/Checkout styling on non-cart and checkout pages. #11694
  • Fix double border in cart and notes field width on mobile. 11742
  • Ensure that incompatible notices are displayed in Safari. #11736
  • Enabled the new blockified Order Confirmation by default for block-based themes. #11615

11.5.3 – 2023-11-08

Bug Fixes

  • Use wp_json_file_decode instead of json_decode 11681

11.5.2 – 2023-11-08

Bug Fixes

  • Rename the Centered Header Menu with Search to Centered Header Menu. 11637
  • Fix decoding issue and pattern. 11681

11.5.1 – 2023-11-08

Bug Fixes

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

11.5.0 – 2023-11-06


  • 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)
  • [CYS] 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


header> element for the checkout header. (11222)

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)

11.4.9 – 2023-11-21

Bug fixes

  • Fixed params passed to woocommerce_before_thankyou for block checkout. This should be an order ID, not an order object. (#11862)
  • Enhance validation for limited use coupons and guest users. (#11860)

11.4.8 – 2023-11-10

Bug Fixes

  • Ensure that incompatible notices are displayed in Safari. 11736

11.4.7 – 2023-11-09

Bug Fixes

  • Fixed address components in Firefox, and editing of address form in the editor. #11714

11.4.6 – 2023-11-09

Bug Fixes

  • Prevent PHP warnings when using Jetpack WooCommerce Analytics module. #11707

11.4.5 – 2023-11-07

Bug Fixes

  • WordPress 6.4: fixed a bug which would break sites using the Classic Template block for the Single Product template. https://github.com/woocommerce/woocommerce-blocks/pull/11455

11.4.4 – 2023-11-06


  • Enabled the new blockified Order Confirmation by default for block-based themes. 11615

11.4.3 – 2023-10-30


  • Improve Hero Product Chessboard pattern. 11423
  • Fix spacing on the “Minimal header” pattern. 11477
  • “Product Gallery” improvements: remove product summary and update margins. 11464
  • Patterns with Search Bar: improve style. 11478
  • “Product Collection X Columns” patterns: align “no reviews” text with the star. 11468
  • Rename the Footer with Simple Menu and Cart pattern. 11487
  • Enhance the Hero Product Split pattern. 11505