Skip to content

Result Filtering Processors

When to Use

When you need to control which facet items are displayed — hiding items with low counts, removing specific values, or showing only narrowing results.

Decision: Filtering Processors

ID Title Stage:Weight Purpose
count_limit Count limit build:50 Hide items below/above a count threshold
hide_non_narrowing_result_processor Hide non-narrowing results build:40 Only show items that would actually filter results
hide_1_result_facet Hide facet with 1 result build:50 Hide entire facet if only 1 option exists
hide_active_items_processor Hide active items build:25 Don't show already-selected items in the list
exclude_specified_items Exclude specified items build:50 Remove specific items by raw value or display text
dependent_processor Dependent facet build:5 Show facet only when another facet has active selection
combine_processor Combine facets build:5 Merge results from multiple facets into one display

Pattern: count_limit Configuration

Setting Purpose
Minimum items Don't show items with fewer than N results
Maximum items Don't show items with more than N results

Example: minimum_items: 2 hides any facet option that would only return 1 result.

Pattern: hide_non_narrowing_result_processor

This is essential for good UX. Without it, facets show options that wouldn't change the result set (100% of results match that option). With it, only meaningful filter options appear.

Pattern: dependent_processor Configuration

Setting Purpose
Facet Which facet must be active
Negate Show this facet when the other is NOT active

Use case: Show "Sub-category" facet only when "Category" has an active selection.

Pattern: exclude_specified_items Configuration

Setting Purpose
Exclude items List of values to exclude (one per line)
Regex Use regex matching
Use display value Match against display text instead of raw value

Common Mistakes

  • exclude_specified_items with translate_entity — If translate_entity runs at weight 5 and exclude_specified_items at weight 50, you can use display text. If you reorder them, you must use raw values.
  • hide_non_narrowing with OR operator — With OR operator, non-narrowing detection works differently. An item that matches all current results is non-narrowing for AND but may be meaningful for OR.

See Also