WooCommerce · Guide
How to Add Product Filters to WooCommerce

Short answer
Add product filters with the free Product Filters block in your Product Catalog template, next to a Product Collection block. For classic themes or extra features such as SEO-friendly filter URLs, use a free filter plugin such as Filter Plus instead.
Key takeaways
- The Product Filters block filters by price, rating, attribute, availability, category, brand, and tag.
- The block needs a Product Collection block in the same template, and it updates results without a page reload by default.
- Use global attributes for filters; custom attributes live on one product only.
- The Rating Filter only appears once at least one product has a customer rating.
- The Mobile overlay is the default, and WooCommerce uses 782px as the breakpoint when no viewport is set.
- Filter Plus is free with AJAX filters, and Pro starts at $29 per year.
What are product filters in WooCommerce?
Product filters let shoppers narrow the products on a shop page by price, rating, attribute, availability, category, brand, or tag.
A shopper who wants blue cotton shirts under $50 should reach them in 2 clicks, not by paging through 200 products. Filters turn a long catalog into a short list that matches what the shopper wants.
WooCommerce core ships a Product Filters block for block themes. It works with the Product Collection block and updates the product list without a full page reload by default, according to WooCommerce's Product Filters documentation.
For background on the platform, read what WooCommerce does.
What do you need before you add filters?
You need global attributes with terms assigned to your products, because custom attributes live on one product only.
A global attribute is created once under Products > Attributes and reused across your whole catalog. A custom attribute is typed into one product and lives only there. Use global attributes for filters so the same Size or Color list works on every product.
WooCommerce's variable product guide shows the split: pick a global attribute from the “add existing” dropdown, or click “Add New” to create a custom one for that product only. For filters, always choose global.
Set up these 3 attributes first if you sell clothing or similar goods: Size, Color, and Material. Add the terms each product actually offers, such as S, M, L, and XL for Size.
For a tour of the settings screens you will use, read WooCommerce settings explained.
How do you add filters with the Product Filters block?
Add a Product Filters block next to the Product Collection block in your Product Catalog template.
- Go to Appearance > Editor > Design > Templates and open the Product Catalog template.
- Add a Product Collection block first if the template has none. Filters need a collection to filter.
- Add the Product Filters block near the collection, such as in a sidebar column.
- Click inside the block and add the filters you want: Price, Attribute, Category, Rating, Availability, Brand, or Tag.
- Add an Active Filters block so shoppers see what they picked and can clear it.
- Save the template and preview the shop page.
WooCommerce's Product Filters documentation gives this exact path and says the block is context-aware: it filters the products in the relevant collection or archive, including product catalog and taxonomy templates.
The block offers 8 filter types: Active Filters, Price, Rating, Attribute, Availability, Category, Brand, and Tag. The taxonomy filters you see depend on the taxonomies your store exposes.
| Filter | What it narrows by | Note |
|---|---|---|
| Price | Minimum and maximum price | Slider with optional fields |
| Rating | Customer star rating | Needs at least one rated product |
| Attribute | Size, Color, and similar terms | Needs global attributes |
| Availability | In stock, out of stock, backorder | List or Chips display |
| Category, Brand, Tag | Product taxonomies | Depends on store taxonomies |
How do you set up global attributes for filtering?
Create the attribute under Products > Attributes, add its terms, then assign the terms to each product.
- Go to Products > Attributes.
- Enter a name, such as “Color”, and click Add attribute.
- Click Configure terms and add each value, such as Blue, Red, and Green.
- Open a product, go to the Attributes tab, and pick the global attribute from Add existing.
- Select the values the product offers and click Save attributes.
WooCommerce's variable product guide says to use “Select All” to add every value, or pick values one by one from the values box. It also says you can set a default sort order for the attribute under Products > Attributes.
The filter options depend on the terms assigned to products in the current collection. WooCommerce's filters documentation says that if an option is missing, check the products in that collection and the terms assigned to them.
Use the Color/image attribute type when you want swatches. The filters doc says the List style can show each term's color or image swatch with its label when the attribute uses that type.
How do you add price, rating, and availability filters?
Add the Price Filter for a min/max slider, the Rating Filter for star ratings, and the Availability Filter for stock status.
The Price Filter lets shoppers pick a minimum and maximum price with a slider. You can show or hide editable price fields, and place them inline with the slider or on a separate line, per WooCommerce's filters documentation.
The Rating Filter shows products by customer rating, with an optional product count next to each rating. It does not appear on the storefront until at least one product has a customer rating.
The Availability Filter offers In stock, Out of stock, and On backorder, depending on your products. Show the options as a List or as Chips, and show the product count for each option if you want.
For the Attribute Filter, choose List or Chips and decide whether to show counts. Chips suit short lists such as sizes; List suits long lists such as brands.
If you add more than one copy of the same filter to a page, their states stay in sync. That lets you put active filters above the collection and selectable filters in a sidebar.
How do you make filters work well on mobile?
Set the Product Filters overlay to Mobile so filters open as a side panel on small screens and stay inline on desktop.
- Select the Product Filters block.
- Open the block settings sidebar and find Overlay.
- Pick Off to keep filters always visible, Mobile for an overlay below a breakpoint, or Always for an overlay at every width.
- With Mobile or Always, pick Left or Right for the overlay position.
- Save and check the shop page on a phone.
Mobile is the default when no overlay setting has been saved, according to WooCommerce's filters documentation. If no tablet or mobile viewport is set, WooCommerce uses 782px as the mobile breakpoint.
You can also set Position to Sticky in the Styles tab to keep the filter panel visible while shoppers scroll. Check that a sticky panel does not cover the product grid on short screens.
Keep the filter list short on mobile. Five filters fit a phone panel; 12 do not. Put price, size, and color first, and move brand and tag filters below them.
When should you use a filter plugin instead?
Use a filter plugin when you need AJAX filters on a classic theme, SEO-friendly filter URLs, or filters for custom fields.
The core Product Filters block is built for block themes. If your theme is classic, or you want filters on archive pages without editing templates, a plugin is the simpler route.
Filter Plus is a free option on WordPress.org. Its plugin page says it adds AJAX filtering by price, rating, category, tag, attribute, color, size, and stock status, with results that update instantly and no page reload. You place it with the [filterplus] shortcode, an Elementor widget, or a Gutenberg block.
Its setup takes 3 steps, per the FilterPlus site: install the free plugin, create a filter set under Filter Plus, and place the widget, block, or shortcode on your shop or category page.
Filter Plus Pro starts at $29 per year, or $59 for a lifetime licence, according to the FilterPlus pricing page checked in November 2026. Pro adds custom post type and custom field filters, SEO-friendly filter URLs, more templates, and an admin order filter.
Before you install any filter plugin, check its page for an HPOS statement. WooCommerce's developer docs note that extension developers must update their code to support High-Performance Order Storage, and WooCommerce's HPOS guide says you can review incompatible extensions under WooCommerce > Settings > Advanced > Features.
For large catalogs, read how many products WooCommerce can handle before you pick a filter method.
How do you check your filters work?
Preview the shop page, apply each filter once, and confirm the product list updates and returns to full when you clear it.
- Open the shop page in a private browser window.
- Pick a price range and confirm only products in that range show.
- Pick an attribute value, such as Blue, and confirm only blue products show.
- Combine 2 filters, such as Blue and under $50, and confirm the list narrows further.
- Click the Active Filters chip to remove one filter, then clear all and confirm the full list returns.
WooCommerce's filters documentation gives the same check: preview the page, select a filter option, confirm the collection updates, then remove the selection and confirm the original results return.
If a filter shows no options, check that products in the collection carry that attribute term. If the Rating Filter is missing, add a review to a product first, because the filter hides itself until a rated product exists.
To track whether shoppers use the filters, read how to set up WooCommerce Analytics.
What mistakes should you avoid?
The most common mistakes are filtering on custom attributes, adding too many filters, and never testing on mobile.
- Do not build filters on custom attributes. They live on one product only and have no terms to filter by.
- Do not add 12 filters to one sidebar. Shoppers use 3 to 5; the rest add noise.
- Do not skip the rating filter check. It hides itself until a product has a rating, which looks like a bug if you do not know.
- Do not forget the Active Filters block. Without it, shoppers cannot see what they picked or clear one choice.
- Do not use the full-page reload setting without a reason. Filters update without a reload by default, and a reload slows every click.
- Do not mix core blocks and a filter plugin on the same page. Two filter systems fight over the same product list.
For store-wide numbers that put filters in context, read WooCommerce statistics.
Frequently asked questions
What is the best way to add product filters in WooCommerce?
The free Product Filters block is the best start for block themes, because it needs no plugin and updates results without a page reload. For classic themes, or when you need SEO-friendly filter URLs and custom field filters, use a free plugin such as Filter Plus.
Do I need a plugin to add product filters?
No. The Product Filters block is part of WooCommerce core and works with the Product Collection block. You only need a plugin when you want features the block lacks, such as filters on a classic theme or SEO-friendly filter URLs.
Why does my attribute not show up in the filter?
Create the attribute under Products > Attributes, add its terms, and assign the terms to your products. Filters can only use global attributes, because custom attributes live on one product only and have no shared terms.
Can filters show as a side panel on mobile?
Yes. Select the Product Filters block, open its settings, and set Overlay to Mobile. Filters then open as a side panel below the breakpoint and stay inline on desktop. The default breakpoint is 782px when no viewport is set.
How much does a WooCommerce product filter plugin cost?
Filter Plus is free on WordPress.org, and its Pro version starts at $29 per year. The free version covers price, rating, category, tag, attribute, color, size, and stock filters with AJAX updates.
Sources
- Product Filters block WooCommerce
- Variable Products WooCommerce
- Filter Plus - WooCommerce Product Filter & AJAX Post Filter WordPress.org
- WordPress Filter Plugin for WooCommerce: FilterPlus WPBens
- High-Performance Order Storage WooCommerce
- HPOS extension recipe book WooCommerce Developer Docs
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


