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: https://docs.woocommerce.com/document/woocommerce-blocks/

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.

  • Featured Product Block
  • Featured Category Block
  • Hand-Picked products Block
  • Best Selling Products Block
  • Top Rated Products Block
  • Newest Products Block
  • On Sale Products Block
  • Products by Category Block
  • Products by Tag Block
  • Products by Attribute Block
  • Product Categories List Block
  • Reviews by Product
  • Reviews by Category
  • All Reviews
  • Product Search
  • All Products
  • Filter Products by Price
  • Filter Products by Attribute
  • Active Product Filters
  • Cart
  • Checkout

Getting Started

Minimum Requirements

  • WordPress 5.4 or greater
  • WooCommerce 4.3 or greater
  • PHP version 7.0 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


This plugin provides 16 blocks.

  • Filter Products by Attribute

  • Product Search

  • Hand-picked Products

  • Product Categories List

  • Products by Category

  • Featured Product

  • Reviews by Product

  • All Reviews

  • Reviews by Category

  • Products by Tag

  • Newest Products

  • On Sale Products

  • Featured Category

  • Active Product Filters

  • Best Selling Products

  • Filter Products by Price


Beautiful yet Puzzling

Manos Psychogyiopoulos
January 1, 2021
The idea, design and execution of these blocks is beautiful, and yet the limitations of the project and the way it is presented reveal a small existential crisis.

Oftentimes it’s impossible to have progress, or growth, without a certain degree of self-disruption — and in this sense, the new Cart/Checkout blocks serve their purpose. Gutenberg had to disrupt the publishing/creating experience in WordPress to keep the platform moving; both the user experience of it, and the tech stack. The WooCommerce Blocks plugin seems to be an exploration of how WooCommerce can fit into the Gutenberg picture — but one without a clear audience or purpose:

– If the project aims to better the checkout experience on those millions of sites currently built with WooCommerce (soon, and not in a distant future), the tech of the “new checkout” should be compatible with those thousands of extensions/plugins in existence.

– If the project aims to create a tightly controlled checkout experience that’s protected from plugin modifications and conflicts, then the decisions made so far make sense, along with the current plan to slowly make these new blocks work with flagship plugins and payment gateways. If this is true, the majority of existing users (developers, builders, merchants) are probably not in the best position to share meaningful feedback: They naturally expect that the new, sleek blocks will work with the plugins on their site, and are always puzzled to find out that this major limitation isn’t communicated anywhere.

I can easily see these Cart/Checkout blocks inside a tightly-managed and regulated version of WooCommerce — one not necessarily designed for today’s users, but for those new users looking for an easy, worry-free version of WooCommerce in the future.

My confusion might be stemming from my own difficulty to see the big picture from where I stand. However, I also can’t help but notice the confusion of dozens of SomewhereWarm merchants who have tried these blocks so far. Please consider shaping their expectations a bit more clearly: Users should not rely on third parties (Vendors) to explain who this project is for, or the vision behind it. The signals given by the core team are mixed and largely contradicting, and the product itself doesn’t do anything to help the average user understand what to make out of it.

Worst plugin

December 30, 2020
My thank you page disappeared, order email not received after using woocommerce block.

No pagination in product list

December 18, 2020
It’s completely nonsensical that there is no pagination in the Products by Category block. You’re limited to the few, nine usually, that fits in the grid

If there is an option to display pagination, I cannot find it.

Fear of the update

December 4, 2020
When it works then is everything is OK. But fear of the update. Every time there is so many changes that make it more hassle than joy. It will not naturally fit to your theme even if it was good with previous one. So i can not recommend it for live stores.

This gutenberg tyranny everywhere :/

It needs to be compatible with custom fields.

November 8, 2020
This plugin is very limited by not supporting custom field.


November 6, 2020
I just installed this plugin is not working I cant make a cart page or the checkout page show me an error every time I make a page
please fix it