• March 24, 2020
  • ๐Ÿ”ฅ added support for SearchWP 4.0.0
  • ๐Ÿ”ฅ auto-populate $_GET variables for ajax refreshes
  • ๐Ÿž added facetwp_use_bigint hook for sites with abnormally large IDs
  • ๐Ÿž prevent the "facetwp-pager" CSS class from being added twice
  • ๐Ÿž clear the "Source other" setting when switching facet types


  • February 21, 2020
  • See 3.5 highlights
  • โ€ผ๏ธ PHP 5.6+ is required
  • โ€ผ๏ธ ACF 5.0+ is required (if using Advanced Custom Fields)
  • โ€ผ๏ธ The WP REST API is required (the deprecated wp_ajax fallback was removed)
  • ๐Ÿ†• the Indexer now uses a temp table to prevent front-end downtime!
  • ๐Ÿ†• added "Any" option for Radio facets
  • ๐Ÿ†• added "Copy shortcode" button for templates
  • ๐Ÿ†• added "Default label" setting to the pager facet (for the "Per page" feature)
  • ๐Ÿ†• FacetWP_Request class for request handling (and for preload logic)
  • ๐Ÿ”ฅ Admin UI - better styling of the "Name" field for facets and templates
  • ๐Ÿ”ฅ Query builder - added "DATE" custom field type, much better date support
  • ๐Ÿ”ฅ removed deprecated mysql_real_escape_string fallback for older PHP versions
  • ๐Ÿ”ฅ accessibility.js support for search facet placeholders
  • ๐Ÿ”ฅ prevent #hash clicks when FacetWP is in use
  • ๐Ÿ”ฅ better styling for layout builder "Color" fields
  • ๐Ÿ”ฅ "pager" and "per_page" shortcodes now use Pager facet logic (DRY principle)
  • ๐Ÿ”ฅ Query builder - replaced vue-multiselect with vue-select
  • ๐Ÿ”ฅ removed the "Spin" loading animation, improved the default loader (Fade)
  • ๐Ÿž filtering error when a pager facet is in use
  • ๐Ÿž pager facet was breaking the selections shortcode (on pageload)
  • โคด๏ธ libs (flatpickr 4.6.3, noUiSlider 14.1.1, SortableJS 1.10.2, Vue 2.6.11, Vue.Draggable 2.23.2)
  • โคด๏ธ translations


  • January 14, 2020
  • ๐Ÿž pager facet showed "1 result" incorrectly
  • ๐Ÿž pager facet labels are translatable via the facetwp_i18n hook


  • December 20, 2019
  • ๐Ÿ”ฅ accessibility.js support for aria-label
  • ๐Ÿ”ฅ accessibility.js support for the user selections box
  • ๐Ÿž reverted search facet readonly during refresh (and increased auto-refresh delay from 250ms to 500ms)


  • November 20, 2019
  • ๐Ÿ†• pager facet type - create pagination, result counts, a "load more" button, or a "per page" box all within the admin UI
  • ๐Ÿ†• added now and today placeholders to the Query Builder
  • ๐Ÿ†• added "Featured" data source (WooCommerce)
  • ๐Ÿ”ฅ adjusted admin UI styling to more closely match WordPress 5.3
  • ๐Ÿž preserve proper order when using a search facet
  • ๐Ÿž remove count from Dropdown user selection labels
  • โคด๏ธ noUiSlider and jQuery Autocomplete
  • โคด๏ธ translation sources


  • November 6, 2019
  • ๐Ÿ”ฅ admin UI tweaks
  • ๐Ÿž disable slider handles momentarily during refresh (prevents excess ajax calls)
  • ๐Ÿž disable search facet momentarily during refresh


  • October 1, 2019
  • ๐Ÿ†• added 3 Layout builder dynamic tags: {{ post:id }}, {{ post:name }}, and {{ post:url }}
  • ๐Ÿ”ฅ only autoload the necessary FacetWP wp_options
  • ๐Ÿž issue with resetting slider values
  • ๐Ÿž "Stop indexer" button now works properly


  • September 10, 2019
  • ๐Ÿž revert "Term order" change due to weirdness with WooCommerce sorting
  • ๐Ÿž nummy.js - use log() instead of log10() because IE sucks
  • ๐Ÿž layout builder - properly handle ACF single-selects


  • August 23, 2019
  • ๐Ÿ”ฅ refactored layout builder ACF support
  • ๐Ÿ”ฅ better admin UI support for code-based facets / templates
  • ๐Ÿ”ฅ code-based facets / templates aren't saved to the DB unless explicitly "unlocked" via the UI
  • ๐Ÿ”ฅ better json_encode() handling of invalid UTF-8 characters for sites on PHP 7.2+
  • ๐Ÿ”ฅ FWP.reset() now accepts a string, array, or object
  • ๐Ÿž autocomplete input type changed to text to fix cross-browser inconsistencies
  • ๐Ÿž User selections feature was incorrectly resetting an entire facet
  • ๐Ÿž display issue with hierarchical checkboxes having "Show expanded" enabled
  • ๐Ÿž explicitly set "orderby" => "term_order" when a facet is sorted by Term Order
  • โคด๏ธ FontAwesome 5.10.1


  • August 9, 2019
  • ๐Ÿ†• facetwp_load_a11y hook to enable accessibility support
  • ๐Ÿ†• facetwp_woocommerce_support_categories_display hook to render facets on WooCommerce product category display pages (experimental)
  • ๐Ÿ†• Proximity - facetwp/geolocation/success and facetwp/geolocation/error JS hooks to get the status of geolocation requests
  • ๐Ÿ”ฅ Layout Builder - better ACF support
  • ๐Ÿ”ฅ FWP.reset() can now reset all facets, a single facet, or an array of facets
  • ๐Ÿ”ฅ Admin - prevent loading image size "crop" values to prevent extra queries
  • ๐Ÿ”ฅ prevent the facetwp_settings_last_index wp_option from being autoloaded
  • ๐Ÿ”ฅ refactored nummy.js (JS number formatter) to support bigger values
  • ๐Ÿž Query builder - width issue for the post type selector box
  • ๐Ÿž prevent the WP GDPR plugin from breaking things
  • ๐Ÿž wrong Spanish translation
  • โคด๏ธ flatpickr 4.6.2
See older versions ยป