Install

Works with Drupal: ^11 || ^12

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 50.07 KB
MD5: 7265d8fad8f5a71a99213802782f078c
SHA-1: 97767d671468f422cec6ca8664daf87f950cd083
SHA-256: 6d959d08d1b28f5bed4847a1adcc1727e68d5ca1078c10697a9e90f447247189
Download zip 83.68 KB
MD5: a0af40795f5aa5d607a58671c08b4a0b
SHA-1: 40bd0f1019163c7fc255f3a1262374a21ffc35a5
SHA-256: 1ca8e3737ed7c0cc26814e1699818f38e6ea877a2a2e30857c5721350bdbaf3e

Release notes

Requirements

Drupal 11 or 12 and Better Exposed Filters ^7.1. Drupal 10 support is dropped; Drupal 12 requires BEF 7.2 or newer. #3602880

Search API and Views Reference Filter support now live in the optional submodules sbef_search_api and sbef_verf.

Changes in 4.0.x

  • Support taxonomy filters with depth, Views Reference Filter, and YearOnly dropdowns. YearOnly requires its dropdown functionality described in #2903879. Filters with an exposed operator are now trimmed too, including collapsible ones. #3132493, #3501300, #3571854
  • Support filters without a field, such as core's "Has taxonomy term", by checking each option instead of failing the page.
  • Add optional hiding when one choice remains and themeable option counts. Option counts now also work with hierarchical select lists. Hidden filters keep the visitor's current selection, including "Hide if
    no options". #3580494, #3624523
  • Fix BEF widget discovery and complete selective-settings schema coverage. #3544573, #3463824, #3569257
  • Preserve contextual arguments, exposed input, defaults, and required selections. #3524941, #3613907, #3503636, #3573461
  • Correct duplicate counts, missing relationship handling, and choices in aggregated SQL Views. #3475819, #3421349, #3518255
  • Fix empty-filter hiding, empty collapsible wrappers, and Apply visibility. #3536021, #3420917, #3432551
  • Fix unloaded Search API entities and indexed-field resolution, loading result items in batches. Avoid Solr's default row cap for unlimited helper queries while preserving the displayed pager; backends that
    extend Search API Solr are covered too. #3442789
  • Optimize simple bundle-filter queries without counts, also when the Search API integration is enabled; document helper hooks and Search API query costs. #3482643, #3425836, #3457937
  • Add regression coverage for multiple selective filters and repeated AJAX selections. #3605967, #3418302
  • Internal cleanup: the three widgets share one trait, and repeated logic moved into shared helpers. The public static API of SelectiveFilterBase is unchanged.

Upgrade notes

Run database updates (drush updb) and rebuild caches after updating. Update 11001 enables sbef_search_api and sbef_verf for views that already use "Show only used items"
on Search API or Views Reference Filter filters. Without it, those filters show all options.

The new one-choice hiding option is disabled by default. Review theme overrides for the items-count span. Solr helper queries now add a count request and may load more entities than before;
complex Views and large result sets can still be expensive.

Verification: 273 tests and 3,316 assertions passed, including real Solr integration tests. Remaining deprecation notices come from Drupal core and contributed modules. An upgrade from 3.0.3 was tested: after
drush updb, taxonomy, Search API and Views Reference Filter views showed the same options and counts as before.

Created by: stomusic
Created on: 14 Nov 2026 at 14:11 UTC
Last updated: 14 Nov 2026 at 14:15 UTC
Bug fixes
New features

Other releases