// Changelog


  • March 28, 2018
  • Change WP / FWP versions are now sent on update checks. This lets us know when to deprecate code. See the stats page »
  • Improve automatically support the facetwp query arg
  • Fix issue with autocomplete facets on WP page templates (props neuralab)
  • Updated flatpickr 4.4.3


  • March 16, 2018
  • New facetwp_acf_object_id hook (to support the User Post Type plugin)
  • Change bumped the GitHub Updater version to WP 4.7
  • Fix fSelect query bug when there's no initial results


  • March 8, 2018
  • Improve "fade" is now the default loading animation
  • Fix don't overwrite custom "post__in" query arg
  • Fix fSelects would freeze when FWP.auto_refresh = false
  • Fix preserve FWP.settings.num_choices when paging
  • Fix autocomplete issue with CSS-based templates (props @mdorchain)


  • February 20, 2018
  • Improve slider facets are now supported for FWP.settings.num_choices
  • Improve re-initialize autocomplete facets only when needed
  • Improve store unfiltered IDs unconditionally
  • Fix user selections feature was sometimes resetting everything
  • Fix issue with "Show ghosts" setting
  • Fix autocomplete facets not returning results (or triggering a 500 error)
  • Fix preload_vars not being passed on pageload
  • Updated flatpickr (again)


  • February 9, 2018
  • Important please update the Map Facet add-on
  • New "Show ghosts" setting for fSelect facets
  • Improve prevent unnecessary "Show ghosts" query when results are unfiltered
  • Improve added "facet_value" parameter to FWP.reset()
  • Improve support for multiple proximity facets on a page
  • Improve JS cleanup and optimizations
  • Fix sanitize term slug within edited_term hook (for Hebrew)
  • Fix FWP.reset() issue with certain facet types (slider, map facet)
  • Fix fSelects in "OR" mode lose selections when filtered then reverted
  • Updated Catalan translations (props Jonathan Pasquier)
  • Updated noUiSlider, jQuery-autocomplete, flatpickr
  • Updated translations


  • January 24, 2018
  • Important please update the following add-ons: [Alpha, Map Facet, Time Since]
  • New facetwp/ajax_settings JS hook (to tweak ajax settings)
  • New facetwp/set_options/autocomplete JS hook (to tweak autocomplete requests)
  • Improve automatic formatting of number range inputs
  • Fix search facet auto-refresh issue
  • Fix issue with Listable + fSelect facets
  • Fix Norwegian translation


  • January 4, 2018
  • New proximity facets now support a radius slider (HTML5 range input)
  • New search facets now have an "Auto refresh" setting
  • Improve modified the facetwp_index table structure for greater efficiency
  • Improve smarter autocomplete search (show only relevant choices)
  • Improve (hierarhical checkboxes) automatically expand children if a parent choice is selected
  • Improve facet type registration has moved to FWP()->helper->get_facet_types()
  • Improve use wp_send_json when possible (props @mgratch)
  • Improve freeze fSelect choices during a refresh
  • Fix fSelect choices incorrect when in "AND" mode
  • Fix slider rendered incorrectly when using back/forward buttons
  • Fix hide the "Soft limit" setting for hierarchical checkboxes
  • Updated to flatpickr v4
  • Updated translations

  • December 11, 2017
  • New the "Re-index" button will glow when re-indexing is needed
  • New added "Copy shortcode" button
  • Improve minified main front scripts
  • Improve fSelect styling (wrap long choice labels)
  • Tweak switched SWP_Query argument from "load_posts" to "fields"


  • November 20, 2017
  • New support for ACF5 Group fields
  • Fix issue with commas within search / autocomplete facets
  • Fix PHP notice for hierarchy facets
  • Fix output the "fwp-loop" tag only if wp_head() has run (props Justin @ Beaver Builder)
  • Fix ignore queries with "suppress_filters" = true
  • Updated translations


  • November 1, 2017
  • Fix SQL issue caused by WP 4.8.3
  • Fix Unable to open fSelects on mobile


  • October 30, 2017
  • New added facetwp_api_output hook
  • New added facetwp/set_options/fselect JS hook
  • Improve one less query for slider facets
  • Improve Query Builder styling tweaks
  • Fix fSelect iPhone fix
  • Fix ignore feeds when doing query auto-detection
  • Fix PHP notice for the facetwp/v1/fetch API endpoint


  • October 4, 2017
  • Improve cache duplicate queries for even faster loading
  • Fix FWP.settings.debug was undefined in some scenarios
  • Fix issue with browser bfcache (back/forward cache)
  • Fix incorrect counts for some preloaded facets


  • September 28, 2017
  • New facets now load instantly on pageload (because magic)
  • New facet choices can now be sorted by Term Order
  • New facetwp_preload_url_vars hook for better facet pre-select
  • New WooCommerce "Product Type" data source
  • New facet base class (FacetWP_Facet) with a get_orderby() method
  • Improve fail gracefully if an invalid post ID is passed to the indexer
  • Improve fSelect counts are now within a .facetwp-counter span
  • Improve extra javascript error handling
  • Change FacetWP_Facet class renamed to FacetWP_Renderer


  • September 12, 2017
  • Improve reset individual facets using FWP.reset('facet_name')
  • Improve FWP.reset() also clears the sort box
  • Improve support FACETWP_LICENSE_KEY constant
  • Improve logic tweak for date range facets with 2 sources + "Exact" mode


  • August 23, 2017
  • Fix revert facet auto-detect on taxonomy archives (due to some edge cases)
  • Fix is_main_query detection should ignore /wp-admin/ queries
  • Fix permalink issue with "_" URL prefix


  • August 18, 2017
  • New rebuilt admin UI
  • New support for custom URL prefixes
  • New added fSelect "Hierarchical" setting
  • Improve hookable admin settings screen
  • Improve fSelect auto-refresh on each selection (when multi-select)
  • Improve cache update checks (transients stink)
  • Improve on taxonomy archive pages, taxonomy facets should show only children of the current term
  • Improve support for "Other data source" setting with ACF date_picker fields
  • Improve support more date range scenarios (e.g. 2 data sources using "Exact" display)
  • Improve proximity "Clear location" setting is now translatable
  • Improve "No results found" text is now translatable
  • Fix proximity issue preventing exact matches from showing
  • Fix incorrect argument order with facetwp/save/{facet_type} JS hook
  • Fix fSelect IE11 selection issue
  • Updated noUiSlider
  • Updated flatpickr
  • Updated translations
See older versions ยป