• May 7, 2024
  • New search facets - added "Enable relevance" UI setting
  • Improved slider facets - only trigger a refresh when the slider handles actually move
  • Improved debug mode - show all FacetWP-related hooks in use (even ones that return a boolean)
  • Improved proximity facets - allow radius unit to be translatable
  • Improved WooCommerce - better counts calculation for the `facetwp_woocommerce_support_categories_display` hook (WC category filtering)
  • Updated dependencies


  • March 12, 2024
  • New pager facet - added "Scroll target" and "Scroll offset" UI settings to fine-tune pager scrolling
  • Improved Date range - hide date range when no dates are available
  • Improved Date range - add placeholder for disabled dates
  • Improved better Multi-site debugging
  • Improved misc styling tweaks and Slider facet styling for RTL support
  • Improved better ACF checks to ensure that fields still exist
  • Fixed change date defaults from 0 to empty string
  • Fixed ensure that Pager facet's scroll offset is an integer


  • January 22, 2024
  • Fixed another Date Range typo (last one!)


  • January 18, 2024
  • Fixed typo causing Date Range facets to break


  • January 17, 2024
  • Improved Google maps - added sessionTokens to (hopefully) reduce the number of API calls
  • Improved added "indexable cpts" to the debug info for easier troubleshooting
  • Fixed some PHP8 deprecation notices
  • Fixed hide the "user selections" area when empty
  • Fixed query detection issue involving SearchWP
  • Fixed added more reserved words for facet/listing names (automatically prefixed with underscore)


  • December 1, 2023
  • Fixed ACF "button_group" fields can now have labels too
  • Fixed query detection issue with SearchWP active


  • November 8, 2023
  • Fixed mysqli notice for sites on WP 6.4+
  • Fixed ctype_digit() notice for sites on PHP 8.1+


  • October 31, 2023
  • Improved short-circuit SearchWP when "s" is empty and a search facet is in use
  • Improved a11y - added `aria-label` attribute for number range facets
  • Fixed preloaded selections now appear in the "User Selections" box
  • Fixed JS error upon reset click for non-existant facets
  • Fixed support - replace ".php" in plugin names to prevent Cloudflare from going haywire


  • September 7, 2023
  • New added "ui_ghosts" setting (needed for range_list and future facets)
  • Improved improved main query detection for when query args are in a slightly different order


  • August 3, 2023
  • Fixed issue preventing "_builtin" post types from indexing


  • August 1, 2023
  • Improved Star rating facet - added new UI color settings
  • Improved enable "Strict query detection" by default for new installs
  • Fixed admin UI - row counts not updating after re-indexing
  • Fixed replaced default post_types from "any" to an actual array, for better WooCommerce compatibility
  • Fixed Listing builder - WooCommerce source field inconsistencies
  • Fixed WooCommerce - hid the `cf/_product_attributes` custom field, in favor of `cf/attribute_*`


  • June 28, 2023
  • New added `facetwp_scripts` WP action to manually add custom scripts
  • New Proximity facet - added Placeholder field
  • Fixed better detection / handling when `facetwp_pre_filtered_post_ids` or `facetwp_filtered_post_ids` hooks are in use
  • Fixed Date range - PHP warning when no end date is set (props Oscar M.)
  • Fixed WooCommerce - prevent issues for custom-translated stock statuses
  • Fixed more PHP8 deprecation notices


  • June 5, 2023
  • Fixed `FWP()->is_filtered` should account for `facetwp_pre_filtered_post_ids` hook usage (fixes Advanced Woo Search)


  • May 17, 2023
  • Fixed admin - prevent caching of index table row counts
  • Fixed admin - plugin install notice listed the wrong add-on name (e.g. "WPML" instead of "Multilingual")
  • Fixed load more - prevent injecting results into static templates
  • Fixed indexer - issue causing index values for a post to clear on save
  • Improved support - include memory stats
  • Improved support - include whether Debug Mode is turned on


  • May 1, 2023
  • Improved include `aria-label` for fSelect dropdowns
  • Fixed admin UI loading issues on Safari
  • Fixed possible undefined facet limits


  • Apr 14, 2023
  • Improved (re-)added notices when necessary integration add-ons are missing
  • Improved admin UI - show the HTTP status code when an ajax request fails
  • Improved migration script efficiency tweaks
  • Fixed Hierarchy facet - changed "Count" setting to "Soft limit" for consistency
  • Fixed Listing builder - switched button items back from HTML button to link elements
  • Fixed "Show indexable post types" UI setting now takes the `facetwp_indexer_query_args` hook into account


  • Mar 20, 2023
  • Fixed PHP 8.2 "AllowDynamicProperties" deprecation notices (props Andrew M.)


  • Mar 6, 2023
  • Improved autocomplete - support `facetwp_facet_display_value` hook
  • Improved listing builder - use a <form> for button links ("A" tags around buttons is invalid HTML)


  • Feb 7, 2023
  • New added `facetwp_proximity_store_latlng` hook
  • Improved listing builder - shortcode support for the "No results text" box
  • Improved WooCommerce - renamed "Include all products" UI setting to "Index out-of-stock products"
  • Fixed ensure that `facetwp_get_distance` returns the closest distance when a post contains multiple locations
  • Fixed SearchWP - prevent extra escaped quotes
  • Fixed proximity - added the (now required) gmap `callback` argument
  • Fixed placeholder text not appearing for autocomplete and search facets


  • Jan 16, 2022
  • New added "No results text" field to the listing builder
  • Improved WP-CLI integration - use temp table, just like the UI version
  • Fixed JSON response - ensure that "action" is a string (3rd party plugins sometimes break this standard)
  • Updated build tools


  • Dec 15, 2022
  • Improved data source dropdown - add taxonomy names after the labels (helps distinguish taxonomies sharing the same label)
  • Fixed listing builder - prevent double timezone offset


  • Nov 10, 2022
  • Fixed query builder - "EMPTY" and "NOT EMPTY" clauses
  • Fixed ACF integration - prevent PHP8 error on invalid parent fields
  • Fixed typo with "Strict query detection" setting, please re-save if using that setting


  • Nov 4, 2022
  • New added experimental "Strict query detection" UI setting
  • Improved index table charset switched to utf8mb4 (for Emoji support)
  • Improved date range - input labels can now be translated via facetwp_i18n
  • Improved date range - a11y support
  • Fixed fSelect lib - fire a change event, even when the value is empty
  • Fixed a11y - added "aria-hidden" to hidden items to prevent ARIA warnings
  • Fixed the `facetwp_template_use_archive` hook should support the "s" argument
  • Fixed query builder - issue with the "EXISTS" / "NOT EXISTS" query filter clauses


  • October 4, 2022
  • Improved tweaked admin UI styling
  • Improved slider - prefix / suffix fields are now translatable via `facetwp_i18n`
  • Improved slider - better styling for the disabled state
  • Improved fUtil lib now supports `.prepend`
  • Fixed checkboxes - choices ordered incorrectly when "Preserve ghosts order" was combined with "Highest count" sort
  • Fixed improved back-compat for the `get_filtered_post_ids` method


  • Sept 15, 2022
  • Fixed query builder - issue when filtering by custom field values
  • Fixed listing builder - move `display: grid` CSS inline to prevent layout shifts


  • Sept 7, 2022
  • Improved revamped the "User selections" logic for number/date range facets
  • Improved refined the sort logic, modified the new `facetwp_facet_sort_options` hook slightly
  • Improved slider facet - display the UI even when only 1 available choice
  • Improved customized noUiSlider.js lib to support `data-disabled` attribute (long story)
  • Improved listing builder - added `post:title` dynamic tag
  • Improved listing builder - renamed "Name" setting to "Unique name" and added tooltip
  • Improved added label to range facet "Compare type" setting
  • Improved fSelect lib - don't auto-focus the search box on touch devices
  • Improved cache the row counts lookup
  • Fixed prevent PHP notices when indexing proximity facets (props @mgratch)
  • Fixed PHP notice caused by undefined `$exists_clause`
  • Fixed fSelect "No results" text wasn't appearing
  • Fixed reset facet didn't reset pager or sort


  • August 25, 2022
  • New `facetwp_facet_sort_options` hook for Sort facets (mimics behavior of the "old" sort feature)
  • Improved display WP compatibility data for update checks
  • Improved auto-ignore "nav_menu_item" and "wp_block" post types
  • Improved number range - when input is focused, Enter key now triggers a refresh
  • Fixed fComplete library - prefix the "hidden" class to prevent conflicts
  • Fixed PHP error when using the API `fetch` method


  • 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

See also