Build your first faceted search

This quick start creates one filter and one live result list. Use representative published content so the counts and matches are meaningful.

Prerequisites

• A supported archive or an existing custom query.
• At least two published items with different values in one taxonomy or short custom field.
• Permission to edit theme settings and the target Page Builder layout.

Configure the context

1. Open Settings → POM Theme → Content model → Faceted search.
2. Enable Enable faceted search if it is off.
3. In the context table, locate the query you want to filter.
4. Select Edit facets.
5. Select Add facet.
6. Enter a customer-facing Label.
7. Choose Checkboxes as Type.
8. Choose the correct Source, then enter its key.
9. Keep Operator as OR for this first test.
10. Leave Enabled active and select Save facets.
11. Return to the context table and select Reindex context.

Wait until the indexing progress completes.

Assemble the page

1. Copy the generated Facet ID from the context editor.
2. Edit the page or template that uses the same archive or custom query.
3. Add Faceted Search Facet and paste the ID into Facet ID.
4. Add Listings (Feed).
5. Match its Query type to the context. For a saved query, choose Custom query and the same Custom queries value.
6. Set Use with faceted search? to Yes.
7. Keep Facet submit mode set to Automatic.
8. Add Faceted Search Counts and Faceted Search Reset.
9. Save the layout.

Verify the result

Open the public page in a private browser window. Confirm that:

• the unfiltered list contains the expected items;
• each checkbox count is plausible;
• selecting one value narrows the cards;
• the URL gains a pf_ parameter;
• Faceted Search Reset restores the initial set.

If the filter is empty, review Debug a facet. For a production layout, continue with Create a filterable listing.