• Dec 2, 2021
  • New added `facetwp_facet_autocomplete_limit` hook to control max results
  • New added "Comment count" as a sort option (layout builder and sort facets)
  • Improved moved some layout builder CSS into `front.css` for easier overriding
  • Improved better instruction text for the query builder's "value" box
  • Improved checkbox facets - show the "Soft limit" setting only when "Hierarchial" is off
  • Fixed proximity facet "Source other" setting (props Jenny)


  • Nov 2, 2021
  • Fixed PHP "null coalescing operator" error for sites running PHP 5
  • Fixed PHP "undefined index" warning for the sort facet


  • Oct 19, 2021
  • New sort facets! Create your own sort boxes from within the admin UI
  • New inheritable facets! Facet types can now inherit the UI from other facet types. Range List is the first add-on to incorporate this feature, letting you choose whether to display a dropdown, checkboxes, radio, etc.
  • New facet field registration (more info coming in 4.0)
  • Improved smarter "re-index" notifier, now ignores non-indexable facets (search, pager, etc)
  • Improved simplified the internal `get_svg` method
  • Improved removed unnecessary Vue dependencies, updated libs
  • Improved tweaked admin UI font sizes, other styles
  • Improved updated admin labels and tooltips for more clarity
  • Improved hide the data source "ACF" header if no ACF fields exist
  • Improved search facet - set autocomplete = "off"
  • Fixed fUtil - return empty results when the selector is an empty string (jQuery parity)
  • Updated translations


  • Sept 17, 2021
  • Improved SearchWP - faster speed by loading only necessary data (props Remco)
  • Improved SearchWP - support additional args passed into SWP_Query (post_type, post_status, meta_query, etc)
  • Improved A11y - added ARIA support for fSelect facets
  • Improved Layout builder - add row count class (r1, r2, etc) to the `.fwpl-result` element
  • Fixed fUtil - `.prev`, `.next`, `.find` and `closest` methods now support multiple selectors
  • Fixed the above fUtil change fixes previously-broken Conditional Logic actions


  • August 30, 2021
  • Improved smarter slider range (now dynamically adjusts even with selected values)
  • Fixed slider pageload quirks (more info)
  • Updated noUiSlider


  • August 20, 2021
  • Fixed WooCommerce - some choices weren't showing for variation-based facets in "OR" mode


  • August 9, 2021
  • Improved use wp_date() instead of DateTime->format() for i18n
  • Improved 3 new pager "Result counts" tags: [page], [per_page] and [total_pages]
  • Improved prevent pager / per page / sort values from getting stored in `FWP.facets` JS object


  • July 9, 2021
  • Fixed move indexing to `init:1000` to allow sufficient time for post type / taxonomy registration
  • Fixed radio facets - force in "OR" mode (props Kari S.)
  • Fixed date picker - edge case offset issue (props Lucas T.)
  • Fixed MS Edge requires JS `catch(err)` instead of `catch` (props George H.)
  • Updated Norwegian translations (props Johan F.)


  • June 29, 2021
  • Improved removed need for `float: right` CSS on Star Rating facets
  • Improved indexer - ensure that `post_author` user exists
  • Improved fetch API - include `term_id` in the response


  • May 25, 2021
  • Fixed issue caused from 3.8.5 script versioning change


  • May 24, 2021
  • New `facetwp_facet_display_value` hook (to customize choice labels)
  • New `facetwp_facet_hierarchy_arrow` (to customize the "Back" arrow)
  • New `get_terms` helper method to bypass 3rd party hooks (*ahem* WPML)
  • Improved redesigned the admin status bar, other design tweaks
  • Improved support versioning of add-on scripts (to bust browser cache)
  • Improved Autocomplete - translatable UI strings
  • Fixed PHP8 "optional before required parameters" deprecation notice


  • May 6, 2021
  • Improved `$params['place_details']` is now available when indexing ACF Google Map fields
  • Improved A11y - support Hierarchy fields
  • Improved Slider facet - the "Compare type" UI setting is now always available
  • Fixed Autocomplete facet - timing issues with some CSS-based templates
  • Fixed Gutenberg (10.5.0) - ignore the `wp_template` post type


  • April 22, 2021
  • Improved more tooltip info for the slider facet's "Format" setting
  • Fixed fully reset the indexer when purging the index table
  • Fixed Dropdown - restore support for jQuery-based enhancement libs (select2, chosen, etc)
  • Fixed PHP notice caused by the "load_jquery" setting
  • Fixed updated vue-select.js to resolve scrolling issues


  • April 6, 2021
  • Improved fUtil.js - enable event bubbling by default
  • Improved fComplete.js - automatically close after selection
  • Improved API - fetch method accepts "application/json" (docs updated)
  • Improved use jQuery if available for document.ready, sort, and per-page boxes (back compat)
  • Improved cache FWP_Helper->get_term_depths()
  • Improved fSelect.js - trigger native JS "change" event
  • Fixed fSelect.js - preserve existing class names
  • Fixed fSelect.js - restore "fs-open" class when open
  • Fixed restored "Go" button for autocomplete facets
  • Fixed JS error for "user selections" when no results
  • Fixed JS error within accessibility.js
  • Updated package.json


  • March 19, 2021
  • Fixed better JSON error handling (due to 3rd party output buffering issues)
  • Fixed better support for 3rd party caching and script deferring (i.e. Autoptimize)
  • Fixed restored the `facetwp/ajax_settings` JS hook
  • Fixed changed `init` hook priority from 10 to 20, some post types (i.e. Pods) were not indexing
  • Fixed load more button
  • Fixed hierarchical checkbox "expand" buttons


  • March 16, 2021
  • Important 3.8 is a MAJOR REWRITE. Please test first on a staging site!
  • New removed jQuery dependency from FacetWP core
  • New fUtil helper JS library (JS abstractions)
  • New fDate date picker JS library
  • New fTip tooltip JS library
  • New fComplete autocomplete JS library
  • New added “settings” to Debug Mode for faster debugging
  • Improved modernized and refactored front-end JS code
  • Improved removed jQuery libraries (query-autocomplete, jquery-powertip, etc)
  • Improved complete rewrite of fSelect JS library
  • Improved raw data is now sent on AJAX requests (less payload)
  • Improved update checks are now made via HTTPS
  • Improved removed upgrade routines > 3 years old
  • Improved fSelect - simplified accents/diacritics removal code
  • Improved add proximity “locate me” to keyboard nav
See older versions