• July 30, 2020
  • ๐Ÿ”ฅ more intuitive hierarchical checkboxes (parents will automatically uncheck when a child is checked)
  • ๐Ÿ”ฅ added ARIA labels for dropdown facets
  • ๐Ÿ”ฅ extra sanitization to trigger fewer false positives with automated security audits
  • ๐Ÿž PHP notices when paged or posts_per_page aren't passed into the API
  • ๐Ÿž Italian translation tweak


  • July 7, 2020
  • ๐Ÿž PHP error for some users when Debug Mode is enabled
  • ๐Ÿž updated "new ticket" URL to prevent 301 redirect


  • July 3, 2020
  • ๐Ÿ”ฅ added hooks_used, row_counts, and last_indexed to the Debug Mode JS output (very helpful when troubleshooting sites)
  • ๐Ÿ”ฅ removed redundant data from the "Show indexer stats" menu
  • ๐Ÿ”ฅ doubled the textarea height for "advanced mode" inputs
  • ๐Ÿ”ฅ mention -1 in the "Count" setting tooltip
  • ๐Ÿž only intercept the first detected EDD [downloads] query


  • June 11, 2020
  • ๐Ÿ†• added "Value modifiers" UI setting to include / exclude certain facet choices
  • ๐Ÿ”ฅ the fetch API method can now be accessed via FWP()->api
  • ๐Ÿ”ฅ added internal facet render_setting method (less code duplication)
  • ๐Ÿž PHP notice involving register_rest_route in WP 5.4.2
  • ๐Ÿ”ฅ layout builder - renamed "Results per row" to "Grid columns"


  • May 27, 2020
  • ๐Ÿ”ฅ more SearchWP 4.0 compatibility tweaks
  • ๐Ÿ”ฅ facetwp_template_use_archive hook (for using shortcode templates on archive pages) now supports the global search page
  • ๐Ÿž pager facet "Load more" now accounts for preloaded vars
  • ๐Ÿž ignore empty $_GET vars (props Jenny)


  • May 6, 2020
  • ๐Ÿ”ฅ the facet "Count" setting now accepts -1
  • ๐Ÿ”ฅ added $context arg to the facetwp_facet_sources hook
  • ๐Ÿ”ฅ only capture FacetWP-related $_GET vars when preloading
  • ๐Ÿž layout builder - issue with link tags inheriting the parent element's border styles
  • ๐Ÿž the facetwp_temp table doesn't exist in rare cases
  • ๐Ÿž typo preventing payment meta from being accessed correctly
  • ๐Ÿž added upgrade routine to fix issue causing the URL prefix to switch unexpectedly from "fwp_" to "_" on older installs
  • ๐Ÿž added IF EXISTS to DROP TABLE clause to prevent MySQL warnings
  • โคด๏ธ sample.json (for clean installs)


  • April 21, 2020
  • ๐Ÿ”ฅ rebuilt the plugin updater. It's now *significantly* faster, and only requires one request to fetch *all* update data (regardless of how many add-ons are installed!)
  • ๐Ÿ”ฅ removed the GitHub dependency for add-on updates
  • ๐Ÿ”ฅ add-on changelogs now appear in the "Plugin Info" modal
  • ๐Ÿ”ฅ changed default URL prefix from "fwp_" to "_"
  • ๐Ÿž only run check_ajax_referer when necessary (fixes WooCommerce issues)


  • April 7, 2020
  • ๐Ÿ†• added "Default label" setting for Hierarchy facets
  • ๐Ÿ”ฅ support "Term order" sort for ACF fields
  • ๐Ÿ”ฅ switched proximity lat/long input types from "text" to "hidden"
  • ๐Ÿž resolved PHP notices involving empty $_GET variables
  • ๐Ÿž better handling of "#" hash links (no longer breaks other plugins)
  • ๐Ÿž add-on updater - bust WP plugin cache for better reliability


  • 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 ยป