Design a results template
The result template decides what each matching item looks like. Faceted Search decides which indexed objects reach that template.
Start with the card
Design one card around the visitor’s comparison task. A directory card might need title, image, location, and category; a resource card might need title, format, date, and excerpt.
Avoid placing long post content in every card. Smaller result payloads make repeated filtering easier to scan and faster to render.
Declare required indexed content
Open Settings → POM Theme → Content model → Faceted search, edit the context, and review:
- Index featured image payload for cards that show the featured image;
- Index derived excerpt for cards that show an excerpt;
- Index post content only when the template truly renders post content;
- Indexed metas for custom values used by the card;
- Gallery for an indexed meta that contains a gallery used in the card.
Taxonomies required by configured facets are indexed automatically. A custom meta displayed by the card still needs to be declared even if another facet uses different data.
Configure Listings (Feed)
- Add Listings (Feed) to the target Page Builder layout.
- Select the intended Query type.
- For a saved query, select the matching Custom queries entry.
- Set Use with faceted search? to Yes.
- Choose the result layout and column settings required by the design.
- Keep the element’s ordinary pagination disabled; use Faceted Search Pager.
If the first visit should show an introduction instead of results, set Show initial results? to No and enter Initial results placeholder. A filtered URL still restores and displays matching results.
Verify every card state
Test cards that have complete content, optional fields missing, long titles, no featured image, and multilingual values where applicable. Then filter, sort, and paginate to confirm the same template remains intact after asynchronous refreshes.
If a field is missing only after filtering, confirm that it is enabled or declared in the context’s indexed content and reindex.
Continue with Results and controls to surround the card grid with the correct interface.