Skip to content
The #1 WooCommerce product filter. 70,000+ shops run it.4.8 / 5 (325 reviews)70,000+ storesFree since 2018V4.0 is here

Works with · Site Editor

Supported

WooCommerce product filter for block themes

Block themes such as Twenty Twenty-Five build the shop in the Site Editor with WooCommerce's Product Collection block, and they do not fire the classic shop hooks. From 4.0 the plugin has its own Product Filter block with a Block theme mode made for this layout. In 3.4.7 there is an older WBW Product Filter block that renders the same filter.

On block themes, add the Product Filter block (4.0) to the Product Catalog template: pick your filter from the list, switch on Block theme mode so it sits inside the Product Collection layout, and save. Tested in the WordPress 7.1 editor. WooCommerce also ships a free Product Filters block; it suits small catalogs but cannot filter custom fields.

Where it goes

Where to add a product filter in block themes

Product Catalog template

Block

Go to Appearance > Editor > Templates > Product Catalog, add the Product Filter block beside or above the Product Collection block, pick your filter and switch on Block theme mode (from 4.0).

Category and tag templates

Block

Repeat in the Products by Category and Products by Tag templates so the filter also shows on those archives.

Automatic placement

Theme hook

In 4.0, Setup can place the filter Above products or as a phone drawer; on block themes it prints the filter in the footer and a small script moves it before the product list.

Older block in 3.4.7

Shortcode

Add the WBW Product Filter block and choose the filter, or a Shortcode block with [wpf-filters id="12"].

Set it up in Block themes

  1. 01

    Create the filter

    Build it in the plugin or with Setup in 4.0.

  2. 02

    Open the template

    Go to Appearance > Editor > Templates > Product Catalog.

  3. 03

    Add the block

    Place Product Filter beside Product Collection, pick the filter and switch on Block theme mode.

Good to know with Block themes

  • Block theme mode wraps the filter in the same layout classes as WooCommerce's core Product Filters block, so it sits beside the Product Collection block without fighting its layout.
  • Setup in 4.0 looks for the product list under .wc-block-product-template on block themes, with Twenty Twenty-Four and Twenty Twenty-Five named in its theme map.
  • Setup in 4.0 also checks whether the core Product Filters block is already placed in a template or block widget. Do not use both on the same template.
  • WooCommerce core reserves the URL parameters categories, tags, brands and filter_stock_status for its own filters.
  • The 4.0 block was tested in the WordPress 7.1 editor; the older block has been in the plugin since 3.1.7.

Status checked 22 Oct 2026 against the plugin code and release notes.

Block theme product filter FAQ

Does Product Filter work with block themes?

Yes. From 4.0 add the Product Filter block to the Product Catalog template and switch on Block theme mode. In 3.4.7 use the older WBW Product Filter block.

How is it different from WooCommerce's free Product Filters block?

The core block suits small catalogs but cannot filter custom fields. Product Filter can, and Pro adds color swatches, multi-select lists and text search.

Can I use both filter blocks?

Not on the same template. Setup in 4.0 notices if the core block is already placed.

Which template do I edit?

Appearance > Editor > Templates > Product Catalog for the shop, plus Products by Category and Products by Tag for those archives.

What does Block theme mode do?

It gives the filter the same wrapper as the core filter block so it fits next to the Product Collection block.

Will it work with Twenty Twenty-Five?

Yes. Setup in 4.0 knows Twenty Twenty-Four and Twenty Twenty-Five and finds the product list for you.

Is it free?

Yes. The block is in the free plugin. Pro adds more filter types.

Add the right filter to your block theme store.

Product Filter Pro: $99 once, or $59 a year.