• August 15, 2022
  • Improved refactored sort logic
  • Improved multisite update notification support
  • Improved a11y - allow for translations of pager-related ARIA attributes
  • Improved query builder - added `EMPTY` and `NOT EMPTY` clauses to the query filter UI
  • Fixed admin UI styling tweaks (font sizes)
  • Updated translations


  • July 22, 2022
  • Improved Query builder styling tweaks
  • Improved value modifiers UI setting supports both HTML entities (e.g. & copy;) and symbols (e.g. ©)
  • Fixed prevent scrollbar shift when using the actions popup (on the facet/template listing screens)
  • Fixed layout builder - `date_format` and `input_format` settings should have a default value
  • Fixed prevent manual indexing issues when the `facetwp_indexer_is_enabled` hook is false
  • Updated VueJS, SortableJS, noUiSlider, and vue-select


  • July 5, 2022
  • Fixed prevent facets from being named `labels` to prevent issues
  • Fixed ignore non-facet (i.e. custom) fSelects


  • June 6, 2022
  • New slider facets - added "Reset text" UI setting
  • Improved admin - only show "Compare type" setting when "Other data source" is used
  • Fixed formatting bug preventing sliders from loading properly


  • May 31, 2022
  • New `facetwp_builder_query_data` hook
  • Improved proximity facets are now up to 40x faster (props And)
  • Improved slider - support "Enclose" compare type
  • Improved added `FWP.response` JS object containing ajax response data
  • Improved Query builder - better styling of vue-select (dropdown) inputs
  • Improved apply `facetwp_facet_display_value` hook to dropdown and fselect facets
  • Fixed moved the `facetwp/set_options/slider` JS hook (allows for "range" to be overriden)
  • Fixed admin - prevent 3rd party menus from moving the top nav bar


  • May 2, 2022
  • Improved admin UI - display facet / template names in the list tables
  • Improved support value-less shortcode atts, e.g. `[facetwp template="test" static]`
  • Fixed prevent reset facets from resetting other reset facets (reset-ception)
  • Fixed sort facet - make default label translatable via `facetwp_i18n` hook
  • Fixed CSS issue when using multiple FacetWP (shortcode) listings on a page
  • Fixed CSS issue preventing listing builder's default 1-column mobile layout
  • Fixed restore a11y compat for the "old" sort feature
  • Fixed counts shortcode display issue when per_page = -1
  • Fixed cast page numbers as `int` for FWP()->facet->pager_args


  • Apr 18, 2022
  • Important FacetWP 4.0 requires PHP 7.0 or above
  • New Reset facets
  • New support for WP Rocket
  • New support for multiple (static) FacetWP templates on a page
  • New ability to duplicate facets/templates from the admin listing
  • New ability to copy facet/template shortcodes from the admin listing
  • New added `post:image` dynamic tag to the Listing Builder
  • New `facetwp_facet_pager_link` hook to customize the pager output
  • Improved much better Listing Builder admin UI
  • Improved tweaked the order of the "Data source" options
  • Improved added `span` around checkbox / radio display values
  • Improved admin.css uses CSS variables to standardize colors
  • Improved better admin UI tooltip help text
  • Improved a11y - better support for pager and sort facets
  • Improved pager - "Per page" facets support a "Show All" option
  • Improved facetwp_display() now supports an optional 3rd argument ($atts)
  • Improved allow sort labels to be translated using `facetwp_i18n`
  • Improved made the admin tooltip UI less subtle
  • Improved renamed "Templates" to "Listings"
  • Fixed sort facet choices by depth only when hierarchical
  • Fixed sort facets should override the default relevancy sort when in use
  • Fixed autocomplete - the UI should adhere to the `facetwp_facet_autocomplete_limit` hook
  • Fixed star rating facets work with the "Hide empty facets" tutorial
  • Fixed issue with multiple EDD `[downloads]` shortcodes on a page
  • Fixed remove Reset and Sort facets from the "User selections" list
  • Fixed prevent duplicate refreshes when using custom fSelect elements
  • Fixed fSelect - when "Hierarchical" setting is off, ignore depth to prevent display issues
  • Updated noUiSlider
  • Updated package.json


  • Feb 15, 2022
  • Improved Value modifiers setting - automatically handle encoded characters (e.g. "&")
  • Improved fSelect - cleaned up styling, removed troublesome "!important" CSS properties
  • Fixed WooCommerce - translation support for static strings (On Sale, In Stock, etc)
  • Fixed auto-ignore the "GDPR Cookie Consent" plugin's post type


  • Feb 1, 2022
  • Fixed Ignore WP 5.9 internal post types (wp_global_styles, etc)
  • Fixed Dropdown - only indent choices when "Hierarchical" setting is enabled
  • Fixed User selections - choices for inherited UI types not displaying correctly


  • Jan 12, 2022
  • Fixed fSelect counts duplicating during paging


  • Dec 30, 2021
  • New added UI setting to toggle accessibility features
  • Improved checkboxes - auto-expand if a checkbox within an overflow is selected
  • Improved layout builder - HTML items automatically parse shortcodes
  • Improved layout builder - added "is-empty" CSS class for empty items
  • Improved fSelect - replaced CSS class "hidden" with "fs-hidden" to prevent conflicts
  • Improved a11y - added `aria-label` attribute to sort facets
  • Improved a11y - added `aria-current` attribute to the pager's current page
  • Improved a11y - better support for checkbox facets
  • Improved a11y - automatically exclude ghost choices from ARIA
  • Fixed handle edge case of `parse_url()` returning false
  • Fixed doc links


  • 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
  • Important Some deprecated JS method names have been removed
  • 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 also