Note: You are viewing the documentation for Version 4View Version 3 Docs

Changelog (v4)

Note: This documentation is for SearchWP 4
SearchWP 3.x: Version 3 Changelog


  • [New] New filter searchwp\\source\\post\\db_where to customize global WHERE limits per post type
  • [New] License key is automatically activated when provided via constant or hook
  • [Fix] Error on uninstall when removing all data
  • [Fix] Issue where Mods were not applied to SWP_Query in some cases
  • [Change] No longer relying on excerpt_more when working with excerpts, now using ellipsis filtered by searchwp\\utils\\excerpt_more
  • [Improvement] Handling of rare cases where index would need to be woken up repeatedly in order to build
  • [Improvement] Omits redundant Entry retrieval in some cases
  • [Improvement] Significant performance retrieval when generating excerpts (e.g. Highlighting)
  • [Improvement] Advanced Custom Fields integration support


  • [Notice] Mods have in part been cleaned up and refined in this release, which may affect your usage. Please review any Mods you are using by testing this update on a staging server. If you are manipulating relevance weight based on date, it is likely you will need to update your hooks. Snippets have been updated on the KB article for review. Please also ensure your SearchWP Extensions are up to date as well.
  • [Fix] Source Mod WHERE clauses causing errors in some cases
  • [Fix] Raw Mod WHERE clauses had no local alias to utilize
  • [Fix] Mod JOIN claus order was not retained causing errors in some cases
  • [Improvement] Optimized Mod handling in SWP_Query
  • [Improvement] Disable integration extension checks when doing AJAX


  • [Fix] Error when using mod argument of \\SearchWP\\Query parameters array
  • [Improvement] Control over Settings page navigation


  • [Note] Rebuilding your index using the Rebuild Index button on the Engines tab of the SearchWP settings screen is recommended after updating
  • [Fix] Delta update regression introduced in 4.0.13
  • [Fix] Error when applying delta update to Source that no longer exists
  • [Improvement] Handling of delta update process during failures
  • [Improvement] Delta update queue handling during index rebuild


  • [Fix] Invalid range in character class introduced in 4.0.15 for PHP 7.3+
  • [Change] searchwp\\tokens\\whitelist\\only_full_matches retagged as searchwp\\tokens\\regex_patterns\\only_full_matches
  • [Change] searchwp\\tokens\\apply_rules_to_whitelist retagged as searchwp\\tokens\\apply_rules_to_pattern_matches
  • [Change] searchwp\\tokens\\whitelist_regex_patterns retagged as searchwp\\tokens\\regex_patterns
  • [Change] Regex pattern matches are now tokenized during indexing (but remain exclusive when searching by default when applicable)
  • [New] Filter searchwp\\tokens\\tokenize_pattern_matches\\indexing to disable new tokenizing of pattern match behavior during indexing


  • [New] New filter searchwp\\tokens\\string to customize strings before tokenization
  • [Fix] Handling of synonyms when finding partial matches
  • [Fix] Implementation and handling of regex pattern match tokenization setting
  • [Improvement] Dash/hyphen and word match regex patterns
  • [Improvement] searchwp\\source\\post\\excerpt_haystack filter now passes arguments array
  • [Update] Translation source


  • [Fix] Issue where partial matches from keyword stems were not found in some cases
  • [Fix] Partial match token processing limited to applicable site(s)
  • [Fix] Excerpt generation when handling unregistered Shortcodes


  • [Fix] Delta update routine when using alternate indexer that caused unwanted exit
  • [Fix] searchwp\\document\\content implementation
  • [Improvement] Index integrity check when rebuilding
  • [Improvement] Source hook management in multisite
  • [Improvement] Upgrade routine process


  • [Fix] Inability to filter searchwp\\settings\\capability
  • [Fix] Issue with Highlighting in some cases
  • [Fix] Document Content not properly considered for global excerpt in some cases
  • [Fix] Warning when reacting to invalid Entry during indexing
  • [Fix] Namespace issue with PDF parsing in some cases
  • [Fix] Unnecessary provider reset when switching to the same site in multisite
  • [Update] Updated updater


  • [Fix] Loss of tokens when applying partial match logic in some cases
  • [Update] Revised MySQL minimum to 5.6 (MariaDB 10.0) because of utf8mb4_unicode_520_ci collation requirement


  • [Fix] Regression introduced in 4.0.6 that prevented non WP_Post results from returning


  • [Fix] Issue where taxonomy Rules for Media were not applied correctly in some cases


  • [Fix] Mod WHERE clauses not restricted to Source when defined


  • [Change] Post is now returned when parent weight transfer is enabled but Post has no post_parent
  • [Improvement] Excerpt handling for native results
  • [Improvement] Additional prevention of invalid WP_Post results being returned in one case


  • [New] Filter to control stemmer locale searchwp\\stemmer\\locale
  • [Improvement] Token stems/partial matches are considered during AND logic pass
  • [Fix] String not sent to searchwp\\stemmer\\custom
  • [Change] searchwp\\query\\partial_matches\\buoy is now opt-in


  • [Fix] Issue where AND logic would not apply in some cases
  • [Fix] Issue where additional unnecessary query clauses are added in some cases
  • [Fix] Issue with delta updates not processing when HTTP Basic Auth is active
  • [Fix] Minimum PHP version requirement check (which is 7.2)


  • [Fix] Issue where tokens table was not reset during index rebuild


  • [New] Support for BETWEEN, NOT BETWEEN, LIKE, and NOT LIKE compare operators for Mod WHERE clauses
  • [Fix] Handling of Mod WHERE clauses in some cases
  • [Fix] Handling of REST parameters when returning search results


  • [New] Check for remnants of SearchWP 3 that were not removed as per the Migration Guide
  • [New] searchwp\\source\\post\\attributes\\comments action when retrieving Post comments
  • [Fix] Handling of empty search strings in some cases


  • [New] Complete rewrite of SearchWP
Fix keyword search on your site. No coding required!

Now you can utilize all of the content that's gone unrecognized by native WordPress keyword search instantly with SearchWP

Get SearchWP