Wordpress Caching Plugins

Wordpress caching or minification plugins can break the Doofinder script

Some Wordpress performance plugins (such as WP Rocket, LiteSpeed Cache, or W3 Total Cache) include features that combine and minify JavaScript files. When these plugins process the Doofinder script, they download it from our CDN and bundle it into a local cached file. This breaks the connection between the script and Doofinder’s configuration servers, causing the search layer to stop working or fail to load.

If your Doofinder layer was working before and suddenly stopped, or if it works only after clearing your site cache, a caching or minification plugin is likely the cause.

How to identify this issue

You can confirm that a caching plugin is interfering with Doofinder by inspecting your site’s HTML source code. If the Doofinder script is being served from a local path like /wp-content/cache/min/ instead of cdn.doofinder.com, the script has been cached locally and needs to be excluded.

To check this, open your website in a browser > right-click anywhere on the page > select View Page Source > search for “doofinder" or "2.x" > if the script URL points to your own domain instead of <code>cdn.doofinder.com, the caching plugin is rewriting it.

See example:

How to fix it: exclude Doofinder from minification and combining

The Doofinder script must always load directly from cdn.doofinder.com. To fix this issue, you need to add an exclusion in your caching plugin so it does not process Doofinder’s JavaScript files.

See a few examples:

WP Rocket

WP Rocket is the most common plugin that causes this issue. To exclude Doofinder scripts:

1. In your Wordpress dashboard, go to WP Rocket.
2. Click on the File Optimization tab.
3. Scroll down to the Excluded JavaScript Files field.
4. Add the following line: cdn.doofinder.com
5. Click Save Changes.
6. Clear Cache to purge any existing cached files.
7. Reload your site and verify that the Doofinder search layer loads correctly.

If your Doofinder installation also loads resources from eu1-config.doofinder.com, add that domain on a separate line as well: eu1-config.doofinder.com

LiteSpeed Cache

1. In your Wordpress dashboard, go to LiteSpeed Cache > Page Optimization.
2. Under the Tuning tab, find the JS Excludes field.
3. Add cdn.doofinder.com on a new line.
4. Click Save Changes and purge all caches.

W3 Total Cache

1. In your Wordpress dashboard, go to Performance > Minify.
2. Under the JS section, find the Never minify the following JS files field.
3. Add cdn.doofinder.com on a new line.
4. Click Save all settings and purge all caches.

Other caching plugins

The principle is the same for any caching or performance plugin: find the JavaScript exclusion settings and add cdn.doofinder.com to the exclusion list. If your plugin is not listed above, check the specific plugin’s documentation for instructions on excluding external JavaScript files.

How to verify the fix

After saving the exclusion and clearing your site cache:

1. Open your site in a browser.
2. Right-click and select View Page Source.
3. Search for "doofinder" or "2.x".
4. Confirm that the script URL now points to cdn.doofinder.com and not to a local /wp-content/cache/ path.
5. Test the search layer by clicking the search icon or typing in the search box.

If the script is still being cached locally, double-check that you saved the exclusion and purged the cache completely. Some plugins require a server-level cache purge as well, depending on your hosting setup.

Need Help?

If you have excluded Doofinder from your caching plugin and the layer still does not load or process updates, contact support. Include the URL of your site and the name of the caching plugin you are using so the team can investigate quicker.