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
- Go to WP Admin → Listeo Core → Browse/Search Options.
- In the Search Logic & Relations block, check Adaptive filters.
- 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.
Step 2: Choose the Behaviour of Each Filter
- Go to WP Admin → Listeo Editor → Search Forms and open a form.
- Click a filter to open its side panel.
- Set the options in the Adaptive filters section (see the table).
- 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 .
Step 3 (optional): Show the Number of Results on the Search Button
- In Listeo Editor → Search Forms, open the form.
- In Form Options, check Results count on search button.
- 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_keysandlisteo_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.phpwithaction=listeo_core_search_facets, the serialized form andlisteo_facets. Public and read-only, no nonce. The AJAX search (listeo_get_listings) returns the same data in itsfacetskey. - 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-countsanddata-facet-range. Options disabled by adaptive filters carrydata-listeo-facet-disabled="1".

