Fixing AjaxSearch 1.8.4 Version Mismatch Errors

A frustrating AjaxSearch failure mode is the message: AjaxSearch error: Version number mismatch. Check the content of the default configuration file This usually happens when the package files, configuration, or template

A frustrating AjaxSearch failure mode is the message:

AjaxSearch error: Version number mismatch. Check the content of the default configuration file

This usually happens when the package files, configuration, or template fragments are no longer from the same version.

Typical Context

[!AjaxSearch?
 &ajaxSearch=`0`
 &pagingType=`1`
 &showInputForm=`0`
 &parents=`in:522`
 &withTvs=`image`
 &tplResult=`tplResult`
!]

What to Check

whether the addon files were partially updated
whether the default config file matches the installed code
whether an old custom template expects fields the new version does not provide

Version mismatch errors are usually a deployment hygiene issue, not a query issue. Keep the package files and config set together and this class of bug becomes much rarer.

Newer post

Using Image TVs Correctly in Slider Markup

A practical reminder that image TVs often already store the full usable value, so slider markup should not rebuild paths blindly.

Older post

Combining AjaxSearch with MultiPhotos or MultiTV Data

How to think about search output when resource cards depend on MultiPhotos, MultiTV, or other image-heavy TV data sources.