Explanation
How Fuzzy Filtering Works
Understand how selected values become WooCommerce product queries and AJAX storefront updates.
This page explains the idea behind Fuzzy filtering. It is not a setup guide; for that, see the tutorials and how-to guides.
The shopper's view
A shopper picks values — a category, a price range, a color — and the storefront responds. Products, the result count, the selected chips, pagination, available values, and the URL all change at once, and the shopper keeps their place in the catalog. There is no full page reload.
What happens underneath
Each filter block maps to data the store already manages in WooCommerce: categories, tags, attributes, price, rating, stock, and sale status. When a shopper selects values, Fuzzy collects the current selection, asks the store for the products that match, and sends back enough information to refresh the page in place.
Refreshing in place is what makes filtering feel instant. Instead of reloading the whole page, Fuzzy updates only the parts that changed: the product grid, the count, the active selection, pagination, the available values in each block, and the price range.
Why available values change as you filter
Filtering narrows the catalog, so some values no longer have matching products. Fuzzy can hide or grey out those values so shoppers do not click into an empty result. This is why a block can show fewer options after a selection: only the values that still lead somewhere remain useful.
Why the URL matters
When the selection is written into the URL, a filtered view becomes a real, shareable address. A shopper can bookmark it, share it, or use the browser Back button, and the same result returns. How the URL is written — query, hash, or clean — is a separate decision covered in the SEO guide.
Where to go next
- Tutorial: Create your first WooCommerce product filter.
- Explanation: How index tables work and why they exist.
- Explanation: How URL modes differ and what they mean for SEO.