What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
The simplest current method is to edit your WooCommerce product-archive template, select the Product Collection block, and enable the filter controls your catalog actually supports. Use categories for broad groups, attributes for values such as size or color, price range for budgets, and stock or sale status for availability. Move to the official Product Filters extension when you need ratings, brands, custom taxonomies, live updates, or more control over filtered URLs.
Antihost offers managed WordPress hosting with free migration, one-click staging and a 14-day free trial.
Choose the right WooCommerce filtering method
WooCommerce offers four practical implementation paths. Start with the core editor when the standard Product Collection controls are enough. Add the official Product Filters extension for a richer shopper-facing experience. Use shortcodes when you are building a custom catalog page that follows the extension’s shortcode model. Choose block extensibility or the Store API when your required query logic cannot be expressed in the editor or extension settings.
As an Amazon Associate I earn from qualifying purchases.
| Approach | Setup surface | Filter depth | Live updates | Block-theme fit | URL and SEO controls | Maintenance burden |
|---|---|---|---|---|---|---|
| Product Collection block | Product-archive template editor | Core catalog controls such as price, categories, attributes, stock, sale, tags, keywords, featured status, hand-picked products, and created date | Depends on the controls exposed by the block | Best starting point for block themes | Basic template behavior; advanced indexation decisions require another approach | Lowest |
| Official Product Filters extension | Extension settings and filter configuration | Attributes, categories, tags, brands, custom taxonomies, price, stock, sale status, and ratings | Products update without a page reload | Use when core controls are not sufficient | Clean filtered URLs plus indexation and sitemap controls | Moderate |
| Filter and products shortcodes | Shortcode-based custom catalog page | Configured through the extension’s filter definitions | Controlled by the extension implementation | Requires care around block compatibility | Depends on the extension and page setup | Moderate; shortcode IDs must match |
| Block extensibility or Store API | Developer code and API queries | Custom query logic, supported collection fields, and customized controls | Can be designed to meet the implementation | Suitable when editor controls are insufficient | Must be designed and tested by the implementer | Highest |
Do not select a filter type merely because it sounds useful. A filter is valuable only when the corresponding product data is complete and consistent. If some products use “Blue,” others use “blue,” and others leave the color attribute empty, the color control cannot produce a dependable catalog experience.
Prepare product data before exposing filters
Filtering queries your catalog data; it does not repair it. Before editing the archive template, inspect the fields you intend to expose.
#1 Best Overall
- Categories: use them for broad, mutually understandable groups. Avoid creating near-duplicate categories that split the same product set.
- Attributes: use global, consistently named values for dimensions such as size, color, material, or compatibility. The same value should not be entered with different spelling or capitalization.
- Prices: verify that every product intended for price filtering has a usable price. Variable products should have prices that represent the variations shoppers can actually buy.
- Stock status: keep availability current. The documented stock values include
instock,outofstock, andonbackorder. - Sale status: make sure sale prices and sale flags are applied to the products you want shoppers to find with an on-sale filter.
- Tags and keywords: reserve tags for meaningful cross-category descriptors rather than repeating every category name.
- Ratings: if you plan to offer rating filtering through the extension, products need matching ratings; otherwise the relevant star levels will not be useful.
Document the intended vocabulary before bulk-editing products. For example, decide whether your catalog will use “Small,” “Medium,” and “Large,” then apply those exact values to every applicable product. This prevents empty filter values and confusing duplicate choices.
Add filters with the Product Collection block
The Product Collection block is WooCommerce’s current core starting point for product catalog, category, tag, attribute, brand, and search templates. In a block theme, the filter controls belong in the template that displays the relevant product archive, not only on an individual product page.
1. Open the correct product-archive template
- Open the WordPress site editor and navigate to the template used for the shop or product archive.
- Open the product catalog, category, tag, attribute, brand, or search template that needs filtering.
- Select the existing Product Collection block. If the template has more than one product collection, select the one that actually renders the catalog grid.
2. Enable the controls your catalog can support
- In the Product Collection block settings, turn on the available filter and sorting controls.
- Enable category filtering for broad product groups.
- Enable attribute filtering for values such as size or color.
- Enable a price-range control when shoppers need to set a budget.
- Enable stock or sale status when availability or promotions are central to the catalog.
- Use tags, keywords, featured status, created date, or hand-picked products only when those controls reflect a real shopping task in your store.
The Product Collection feature documents controls for price range, categories, tags, product attributes, hand-picked products, on-sale products, featured products, keywords, stock status, and created date. A custom collection can also be constrained by sale status and stock status. Do not expose every available control automatically; too many choices make a small catalog harder to scan.
3. Match each control to a real product field
Use a category control for a category taxonomy, not for color values that belong in an attribute. Use an attribute control for size or color, not for a one-off campaign label that should be a tag. Use stock filtering only after stock statuses are being maintained accurately. This alignment is what makes a selected value return the products a shopper expects.
4. Save and test every archive context
- Save the template after enabling the controls.
- Open the shop page and test one filter at a time.
- Repeat the test on a category, tag, attribute, brand, and search archive if your theme uses those templates.
- Combine two filters, such as a color attribute and a price range, and confirm that the result set remains relevant.
- Test an empty-result combination so you can provide a clear no-products message through your theme or catalog design.
A filter can appear correctly while returning poor results if product assignments are incomplete. Test with known products, including at least one product that should match and one that should not.
Use the official Product Filters extension for advanced catalogs
Choose the official Product Filters extension when the core Product Collection controls do not cover the way customers browse your catalog. Its documented filter types include attributes, categories, tags, brands, custom taxonomies, price, stock status, sale status, and rating.
Recommended Free Tools
What the extension adds
- Broader taxonomies: combine standard catalog fields with brands and custom taxonomies.
- Availability controls: expose in-stock, out-of-stock, and back-order choices when products with those statuses exist.
- Rating controls: expose star levels that have matching products instead of presenting choices that lead nowhere.
- Live catalog updates: products update without a full page reload, which makes repeated refinement faster for shoppers.
- URL and SEO controls: use clean filtered URLs and configure indexation and sitemap behavior.
Configure filter logic deliberately
The extension combines values selected within one filter with OR logic and combines different filters with AND logic. Selecting “Small” and “Medium” in the same size filter therefore includes products matching either value. Selecting “Blue” plus an in-stock filter narrows the result to products satisfying both conditions.
This distinction should shape the labels you show. A shopper selecting multiple colors generally expects alternatives, while selecting a color and a stock condition generally expects both requirements to apply. Test combinations with real products before publishing the filter panel.
Configure stock and rating choices
Stock choices should represent statuses that actually exist in the current catalog. If there are no products on back order, presenting a back-order option adds noise. Likewise, rating levels should correspond to products with matching ratings. Review these values after major catalog imports or stock changes.
Make an SEO decision for filtered URLs
Clean filtered URLs can be useful for sharing and for stable landing pages, but every filter combination should not automatically be indexed. Index only combinations that have useful, durable content and a clear search purpose. Leave transient combinations, empty result sets, and near-duplicate pages out of indexation when the extension’s controls allow that choice. Coordinate indexation and sitemap settings so search engines receive the same signals.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Build a custom catalog with shortcodes
Shortcodes are an option when you need a dedicated catalog page rather than a template-level Product Collection block. The documented setup places the filter shortcode and the products shortcode on the same page and gives both the same filter ID. Sorting can be enabled on the products shortcode.
Shortcode setup checklist
- Create or edit the custom catalog page.
- Insert the extension’s filter shortcode and note its filter ID.
- Insert the products shortcode on the same page.
- Assign the identical filter ID to the products shortcode so the two components communicate.
- Enable sorting on the products shortcode if shoppers need to reorder results.
- Publish the page and test a single filter, a multi-value selection, sorting, and an empty result.
The extension documentation states that its filter shortcode is not supported inside WooCommerce Blocks’ Products block. A shortcode filter therefore should not be dropped into a block-based Products block with the expectation that it will control that grid. Use a shortcode-driven products output for the shortcode approach, or use the Product Collection block’s own controls for a block-based archive.
Extend filtering with block APIs or the Store API
Use the developer route when the editor and extension cannot express the required logic—for example, a specialized query, a custom control, or a layout that must be generated by code. WooCommerce’s developer references expose query attributes for product attributes, stock status, price range, hand-picked products, and layout, and identify controls that can be hidden or customized.
Decide whether code is justified
- Use core settings when the requirement is a standard category, attribute, price, sale, or stock filter.
- Use the extension when the requirement is broader taxonomy coverage, ratings, live updates, or managed filtered URLs.
- Use code only when the required query or presentation cannot be represented by those options.
Plan a coded implementation
- Write down the exact product fields and combinations the interface must query.
- Map each field to a supported Product Collection or Store API query attribute.
- Define which controls should be visible, hidden, or customized.
- Test single filters, multiple values, no-result combinations, pagination, sorting, and stock changes.
- Retest after WooCommerce, theme, or extension updates because custom integrations carry the highest maintenance burden.
Keep custom logic narrowly scoped. Replacing a standard price or attribute control with code creates extra debugging work without improving the shopper experience unless the store has a demonstrable requirement.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Organize a filter panel shoppers can understand
Start with high-intent filters
Place the fields that answer the most common buying questions first: category or product type, a key attribute such as size or color, price, and availability. Put less frequently used fields such as created date or an internal tag later in the panel.
Use labels that match catalog language
Call the control “Color” if the product attribute is color, and use the same value spelling shoppers see in product details. Avoid exposing technical taxonomy names or duplicate labels for the same field.
Best Value
Prevent dead ends
Do not offer values that never match a product. Keep stock and rating options synchronized with actual catalog data, and check combinations that logically produce no results. A clear empty state is preferable to a filter that appears broken.
Keep sorting separate from filtering
Filtering decides which products remain; sorting decides their order. Product Collection controls and the products shortcode can expose sorting separately. Make both controls understandable so a shopper does not mistake a reordered list for a changed filter result.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallOutdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchTroubleshoot filters that do not work
The filter is visible but returns no products
- Open a product that should match and verify its category, attribute value, price, and stock status.
- Check spelling and capitalization for attribute terms.
- Test the filter by itself before combining it with another filter.
- For stock or rating choices, confirm that products with the selected status or rating actually exist.
The wrong products appear
- Confirm that the control is querying the intended taxonomy or attribute rather than a similarly named field.
- Review products assigned to multiple categories or attribute values.
- With the extension, remember that values within one filter use OR logic while different filters use AND logic.
A shortcode filter does not affect the product grid
- Confirm that the filter and products shortcodes use the same filter ID.
- Make sure the products output is shortcode-based.
- Do not place the filter shortcode inside the WooCommerce Blocks Products block; that combination is documented as unsupported.
Filtered pages create SEO problems
- Review which combinations are indexable rather than allowing every possible combination to become a search page.
- Use clean URLs only for combinations with useful, stable catalog content.
- Align indexation and sitemap settings so temporary or empty combinations are not promoted as landing pages.
The custom implementation breaks after an update
Recheck the supported query attributes, hidden-control settings, template markup, and Store API requests. Reproduce the problem with one filter before testing complex combinations, then compare the coded behavior with a core Product Collection configuration. Keeping a documented field map makes this diagnosis faster.
A practical decision checklist
- Use Product Collection first when you have a block theme and need standard catalog filters.
- Use the official Product Filters extension for brands, custom taxonomies, ratings, live updates, or controlled filtered URLs.
- Use shortcodes for a custom page built from a filter shortcode and products shortcode with the same filter ID.
- Use block extensibility or the Store API only for requirements the editor and extension cannot express.
- Audit product data before troubleshooting the interface; inconsistent attributes and stale stock statuses are common causes of poor results.
- Test combinations and empty states on every archive context that uses the filter.
Final recommendation
For most block-theme stores, begin with the Product Collection block in the relevant product-archive template and expose only categories, attributes, price, and availability fields that are maintained consistently. Add the official Product Filters extension when shoppers need richer taxonomies, ratings, live updates, or SEO-aware filtered URLs. Reserve shortcode pages and custom Store API or block development for cases where those two paths cannot represent the catalog’s actual buying logic.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
