Facets Summary
When to Use
Use this guide when you want to display active facet selections as removable breadcrumbs — "Color: Blue (x) | Size: Large (x) | Reset all".
Decision
Module: facets_summary
Entity: FacetsSummary (config entity)
Admin: /admin/config/search/facets/facet-summary/add
Summary processors:
| ID | Title | Purpose |
|---|---|---|
show_summary_processor |
Show a summary of active items | Display selected filter values |
show_count_processor |
Show result count | Display total results matching filters |
show_text_when_empty_processor |
Show text when empty | Message when no filters are active |
reset_facets_processor |
Reset all filters | Add a "Reset all" link |
Alternative: The Facets docs recommend views_filters_summary as a replacement for facets_summary. It works with any Views filter (not just facets) and integrates with the exposed filters approach.
Pattern
drush en facets_summary
- Go to
/admin/config/search/facets - Click "Add facet summary"
- Select the facet source
- Enable processors (show summary, reset, etc.)
- Place the summary block in your layout
Common Mistakes
- Wrong: Using
facets_summarywith the exposed filters approach → Right: For exposed filters, preferviews_filters_summary— it integrates natively with the Views exposed form.
See Also
- Facets Exposed Filters — using with exposed filters
- Overview — sub-module overview
- Reference:
web/modules/contrib/facets/modules/facets_summary/