Inicio - Documentación - POM Theme - 07 Faceted search - 07.1 Recipes - Build a filterable product catalog

Build a filterable product catalog

A product catalog should help shoppers reach a valid product set quickly without duplicating permanent shop visibility rules in facets.

Choose the base collection

Use the WooCommerce context for the shop or product taxonomy being enhanced. The base WooCommerce query remains responsible for the current archive and product visibility.

Select product facets

A practical catalog may use:

  • Checkboxes or Hierarchy for product categories;
  • Color for an attribute whose terms contain color or image swatch data;
  • Searchable select for a long attribute list;
  • Number range slider for price;
  • Rating for review rating;
  • Not empty for a supported value where presence itself is meaningful.

Choose OR when selecting “blue or green” should return either attribute. Choose AND only when products must carry every selected value.

Configure ordering

Add Faceted Search Sort with relevant options, for example:

default:Default,price_asc:Price low-high,price_desc:Price high-low,rating_desc:Top rated,date_desc:Newest

Do not offer price or rating order on a collection whose indexed product data cannot support it.

Compose the shop interface

  1. Place primary facets before secondary attributes.
  2. Show current selections and reset near the product count.
  3. Use the WooCommerce-compatible Listings (Feed) configuration for the context and enable Faceted Search.
  4. Add one Faceted Search pager.
  5. Keep page-size options conservative for image-heavy product cards.

Acceptance checks

Test products with several terms in one attribute, products lacking an optional attribute, variable products where applicable, zero-count choices, price boundaries, rating order, later pages, and mobile controls.

If a swatch is missing, verify the attribute taxonomy, term media, and stored term swatch data before changing the facet type.