Adaptive filters make your search forms react to the current search. Options that would return no listings are greyed out or hidden, options can show how many listings they match, such as “Diesel (12)”, and sliders can take their range from the current results. The search button can also read “Show 2,000 listings”. You turn the feature on once in Listeo Core → Browse/Search Options, then choose the behaviour for each filter in Listeo Editor → Search Forms.

Before You Start

You need Listeo theme, Listeo Core, Listeo Forms & Fields Editor and Listeo Elementor 2.3 or newer. Update them together. Adaptive filters are off by default. Nothing changes in your search forms until you turn them on.


What Adaptive Filters Do

Without adaptive filters, a visitor can combine filters that match nothing and only finds out on the empty results page. With adaptive filters enabled:

  • Empty options are disabled or hidden. After choosing Make = Honda, the Condition option “New” is greyed out if no new Honda is listed.
  • Counts (optional) show next to each option, for example “Electric (8)”.
  • Slider range (optional): a Price or Mileage slider uses the lowest and highest value of the listings found.
  • Result count on the search button (optional): “Show 245 listings”, updated while the visitor picks filters.

The selected option is never disabled or hidden, so a visitor can always undo a choice. For a single-choice filter, or a multiple-choice filter whose options are combined with OR, the counts ignore that filter’s own choice. After choosing Honda, the other makes keep their counts, so the visitor can switch to another make. When several options of one filter are combined with AND, the counts include the filter’s own choice, because each extra option narrows the results.

When to use it

  • Classifieds and marketplaces with many filters (make, model, fuel, condition, body type).
  • Any site where visitors often end up on “No listings found”.

Step 1: Turn On Adaptive Filters

  1. Go to WP Admin → Listeo Core → Browse/Search Options.
  2. In the Search Logic & Relations block, check Adaptive filters.
  3. Save the settings.

From now on, every option filter in your search forms disables its empty options. That is the default behaviour. Counts and slider ranges stay off until you turn them on per filter in Step 2.

Note Counts follow the search logic in the same block. Different taxonomies (for example category and region) are always combined with AND. Default relation between selected terms of one taxonomy and the per-taxonomy {Taxonomy} search logical relation settings decide how several terms of one taxonomy are combined.


Step 2: Choose the Behaviour of Each Filter

  1. Go to WP Admin → Listeo Editor → Search Forms and open a form.
  2. Click a filter to open its side panel.
  3. Set the options in the Adaptive filters section (see the table).
  4. Click Save Changes.
Setting Choices What it does
Options without results Use default, Disable, Hide, Show What happens to options that would return no listings. Disable greys them out, Hide removes them from the list, Show leaves them as they are. Use default means Disable.
Show counts On / off (default off) Shows the number of matching listings next to each option.
Range from current results On / off (default off), sliders only The slider minimum and maximum follow the listings found by the current search.

Which filters support it

Element Disable / hide / counts Range from results
Taxonomies: Checkboxes in column, Checkboxes in row, Select Taxonomy, Chained select Yes No
Listing Fields with options: select, multi select, checkboxes, Buttons (pick one) Yes No
Slider (price or any number field) No Yes
Drilldown Taxonomy, From/To inputs, Select: up to, Select: from, text and keyword inputs, location, dates No No

The settings show only for elements they apply to. More about each element type is in the Search Form Elements Reference .

Tip Start with Disable everywhere and Show counts only on the filters people use most (Make, Fuel, Body type). Counts on every filter make the form busy. Use Hide for long checkbox lists, so only useful options remain.


Step 3 (optional): Show the Number of Results on the Search Button

  1. In Listeo Editor → Search Forms, open the form.
  2. In Form Options, check Results count on search button.
  3. Click Save Changes.

The button reads, for example, “Show 2,000 listings” and follows the selected filters. When nothing matches it reads “No listings found”.

  • It needs Adaptive filters (Step 1). Without it the button keeps its normal text.
  • It works on forms with a search button: fullwidth and boxed forms, and sidebar forms when AJAX browsing is off. The split page form (Search on Half Map Layout) does not have this option.
  • In a shortcode you can turn it on or off per form: [listeo_search_form source="search_on_home_page" count_button="on"].

Page Caching and Performance

  • Counts load after the page. The page itself is not changed, and the browser asks for the counts separately. Adaptive filters therefore stay correct when your pages are cached by a caching plugin or your host.
  • With AJAX browsing, the counts arrive together with the new results, so there is no extra request.
  • Nothing is written to the database. If your site has a persistent object cache (Redis, Memcached), Listeo uses it.
  • Large result sets: when a search matches more than 5,000 listings, Listeo shows the overall counts of the taxonomy terms and does not grey out or hide anything. The button reads “Show 5,000+ listings”. Narrow the search and the exact counts come back.

Limitations

  • Searches that are not counted on page load: location and radius searches, Open now, AI search, and keyword searches when Keywords search mode(Listeo Core → Browse/Search Options) is set to Fibo Search or Search WP compatibility. Counting them would repeat a paid lookup (geocoding, AI, an external search engine). When the page loads with such a search, or when a form that is not on a results page (for example a home page form) holds one, the options stay as they are and the search button keeps its normal text. On a results page with AJAX browsing on, the counts come back with the next AJAX results, for example as soon as the visitor changes a filter, because that request already ran the lookup.
  • Drilldown taxonomies and From/To inputs have no counts.
  • Older listings that store a multi-value field as one comma-separated or serialized value are not counted correctly.
  • When one search combines more than three filters with their own selection, some filters show counts only and do not disable options.
  • Elementor Listings widget: a search form on the same page that drives the widget’s results with AJAX browsing gets counts like on the listings page. The counts include the category, region, feature and listing type the widget is limited to. Other widget settings that the AJAX search does not receive are not in the counts either.
  • In the Elementor Search Card widget, the counts of a tab load when the tab is first shown.
  • Plugins that replace the listing results (for example ElasticPress or SearchWP integrations) are not consulted. Counts follow Listeo’s own database query.

FAQ and Troubleshooting

  • Counts do not show at all

  • Options are not greyed out, but counts are shown

  • The search button does not show the number of results

  • A count looks wrong

  • Does this slow down my site?

  • Will my existing search forms change after the update?


Related Articles

  • Search Form Elements Reference
  • Related Taxonomies and Chained Select
  • Custom Taxonomies
  • Field Visibility Rules : hide whole filters until they apply.
  • Search Forms Editor / Search Filters

For Developers

The logic lives in Listeo_Core_Search_Facets. The global switch is the option listeo_adaptive_filters ('on'). The element settings are stored as facet_empty, facet_counts and facet_range on the search form element.

PHP filters

  • listeo_core_adaptive_filters_enabled ( $enabled ): force the feature on or off.
  • listeo_core_facets_threshold ( $threshold, $descriptors ): the number of results above which overall counts are used (default 5000).
  • listeo_core_facets_max_disjunctive ( $budget ): how many filters with their own selection get exact counts per request (default 3).
  • listeo_core_facet_meta_keys and listeo_core_facet_range_keys: the field keys that may be counted. Only keys of choice and slider elements of saved search forms are allowed by default, because the endpoint is public.
  • listeo_core_facets_request_off ( $off, $request ): return true to skip counts for a request.
  • listeo_core_search_facets ( $facets ): the computed response.
  • listeo_core_search_count_button_label ( $label, $total, $capped ): the search button text.

Endpoint and JavaScript

  • Page load counts: POST to admin-ajax.php with action=listeo_core_search_facets, the serialized form and listeo_facets. Public and read-only, no nonce. The AJAX search (listeo_get_listings) returns the same data in its facets key.
  • Response: { mode: "results" | "global" | "off", total, taxonomies, meta, ranges, partial }.
  • window.listeoSearchFacets.refresh( form ): load and apply the counts of a form now, for example after you show a hidden form.
  • window.listeoSearchFacets.watch( form ): start the search button count of a form added after page load.
  • window.listeoSearchFacets.last( form ): the last counts applied to a form.
  • Filter wrappers carry data-facet, data-facet-empty, data-facet-counts and data-facet-range. Options disabled by adaptive filters carry data-listeo-facet-disabled="1".