✅ Compatibility Guide

Check if FlatSearch.Pro fits your store.

FlatSearch.Pro is built for Flatsome + WooCommerce stores that want faster, smarter, and cleaner product search.

This page explains what works best, what is optional, what needs testing, and what to check before installing.

Best-fit store setup

🎨
Flatsome Theme
Main theme target
Best fit
🛒
WooCommerce
Products, prices, images, stock
Required
☁️
Cloudflare
Optional fast search cache
Optional
🧠
Redis / Object Cache
Optional server memory boost
Optional
Quick answer

FlatSearch.Pro is best for this setup.

If your store matches this setup, you are in the best compatibility zone.

🎨

Flatsome

Main supported theme. FlatSearch.Pro improves the existing Flatsome search box.

Best fit
🛒

WooCommerce

Required for products, prices, product images, stock, and product results.

Required
🧩

WordPress

Works as a WordPress plugin. Keep WordPress, WooCommerce, and Flatsome updated.

Required
🛡️

Backup first

Always backup website files and database before installing on a live store.

Important
Best setup is WordPress + WooCommerce + Flatsome. Backup first, install second, test third.
System requirements

Minimum things your site should have.

Edit the exact version numbers below if your public requirement changes.

Item Status Simple explanation Recommended action
WordPress Required FlatSearch.Pro is a WordPress plugin. Use a maintained WordPress version.
WooCommerce Required Needed for product data, prices, images, stock, and search results. Keep WooCommerce updated and test after major WooCommerce updates.
Flatsome Theme Best fit The plugin is built around Flatsome live search behavior. Use a normal Flatsome header search setup for best results.
PHP Required Your server must run a modern PHP version supported by WordPress/WooCommerce. Use your host’s recommended stable PHP version.
HTTPS Recommended Secure pages help checkout, browser features, and trust. Use SSL/HTTPS across the whole site.
Object Cache / Redis Optional Can help repeated search work when stable. Use only when properly configured by your host.
Cloudflare Optional Needed only for Cloudflare Fast Search and optional CDN behavior. Turn on Cloudflare features only if your site uses Cloudflare.
Theme compatibility

Built for Flatsome first.

Many search plugins try to fit every theme. FlatSearch.Pro focuses on the Flatsome search experience.

Best fit

Flatsome Theme

Designed for the default Flatsome live search box, mobile search popup, and WooCommerce product search flow.

Needs testing

Flatsome Child Theme

Usually fine, but custom child theme code can change search HTML, CSS, JavaScript, or AJAX behavior.

Not main target

Other themes

Some features may work, but FlatSearch.Pro is not built as a generic search plugin for every WordPress theme.

Important: If your developer heavily customized the Flatsome search icon, popup, or live search template, test on staging first.
WooCommerce compatibility

Works with real WooCommerce product data.

FlatSearch.Pro is designed around WooCommerce products, prices, images, stock, and product search results.

WooCommerce area Compatibility Notes
Simple products Supported Search result rows can show product title, image, price, URL, and stock-related behavior.
Variable products Supported / test recommended Works with normal WooCommerce variation product setup. Test stores with complex custom variation plugins.
Product images Supported Better Search Images and Small Image Guard help choose safer dropdown images.
Prices Supported Search can display prices and support price search words like “under 500”.
Stock status Supported Results page sorting can prioritize available products depending on settings.
Custom product types Needs testing Membership, booking, auction, subscription, bundle, or heavily custom product types should be tested on staging.
HPOS orders Normally unrelated FlatSearch.Pro focuses on product search, not order storage. Still test if your site has many order/admin customizations.
Cache & CDN compatibility

Cache can help, but it must be cleared after changes.

Search speed may involve browser cache, page cache, object cache, and Cloudflare cache.

☁️

Cloudflare

Cloudflare Fast Search is optional. It can help repeated public searches load faster when cache rules are correct.

  • Useful for repeat searches.
  • Test HIT / MISS behavior.
  • Purge after major setting changes.
🧠

Object Cache / Redis

Memory Cache Boost can help when object cache is stable and properly configured by your host.

  • Good for repeated server data.
  • Clear after updates.
  • Useful on busy stores.
🧹

Page cache

Page cache can help your website, but old cache can show old search scripts or stale helper data.

  • Purge after plugin update.
  • Test in Incognito.
  • Clear local browser cache if needed.
Cache is memory. Memory is good when fresh. Memory is bad when old.
Speed plugin compatibility

Works best when search scripts are not broken by optimization.

Speed plugins are useful, but aggressive JavaScript delay or minify settings can break live search if not tested.

Tool type Compatibility What to check Best action
FlyingPress Compatible, test settings Delay JS, minify JS, cache purge, preload behavior. Use Delay JS Search Protection if search does not open or type correctly.
WP Rocket Compatible, test settings Delay JavaScript execution, combine/minify, cache purge. Exclude search-related scripts if live search fails.
LiteSpeed Cache Compatible, test settings JS delay, object cache, page cache, ESI/custom cache rules. Clear LiteSpeed cache after changing FlatSearch.Pro settings.
Autoptimize / Perfmatters Needs testing Delayed scripts, deferred scripts, removed scripts, lazyload rules. Test live search on desktop and mobile.
Image optimization plugins Usually compatible Missing thumbnails, WebP/CDN rewrites, placeholder images. Use Better Search Images and Small Image Guard; regenerate thumbnails if needed.
Important: If search works before enabling a speed plugin setting but breaks after enabling it, the optimization setting may be delaying or changing the search script.
Image compatibility

Dropdown images should be small, safe, and not broken.

Search images can be affected by thumbnails, image optimization plugins, CDNs, WebP rewriting, and product image data.

🖼️

Better Search Images

Chooses small product photos for dropdown results instead of large original images.

🛡️

Small Image Guard

Checks for broken, oversized, or unsafe images and swaps them to safer images or placeholders.

☁️

Cloudflare Image Resizing

Advanced option only. Use it only if your Cloudflare plan and domain support Cloudflare Image Resizing.

Common fix: If old products show grey or broken thumbnails, regenerate WordPress thumbnails and clear all caches.
Module compatibility

Feature modules should still work across search routes.

FlatSearch.Pro is designed so modules do not only work in one mode. The goal is stable behavior when Fast Index or Cloudflare is on or off.

Module Fast Index route Default Flatsome route Compatibility note
Better Word Matching Supported Supported Should help exact, multi-word, and product-family searches.
Typo Fix Supported Supported Helps misspelled product or brand words.
Search From First Letter Best with index Supported with bridge Large catalogs should use Fast Index for short-prefix search.
Price Search Words Supported Supported Examples: “under 500”, “above 100”, “between 20 and 50”.
Page & Blog Search Supported Supported Should supplement product results, not replace good product matches.
Better Search Images Supported Supported Uses safer product image selection.
Guided Answer Search Supported Depends on setup Best tested with the plugin live search route and published answer cards.
Cloudflare Fast Search Designed for it Not applicable Cloudflare caches fast-route responses, not the default admin-ajax route.
Search route behavior

What happens when Fast Index or Cloudflare is on or off.

This table helps users understand which route should answer search.

Fast Index Engine Cloudflare Fast Search Expected route What should happen
ON ON /?fsp&q=keyword Fast Index prepares the answer. Cloudflare can cache repeated public searches.
ON OFF /?fsp&q=keyword Fast Index answers from your server without Cloudflare cache.
OFF ON /?fsp&q=keyword if index data is ready Fast route can be used when safe; otherwise it should fall back safely.
OFF OFF admin-ajax.php Default Flatsome live search route is used with compatibility bridge behavior.
Best test: Open browser DevTools → Network tab → type a search word → check whether the expected route appears.
Store data compatibility

Some store setups need extra testing.

Every WooCommerce store can be customized differently. Test these areas on staging when they apply to you.

Needs testing

Multilingual stores

WPML, Polylang, TranslatePress, or other translation tools can change product titles, URLs, and search data. Test each language.

Needs testing

Multi-currency stores

Currency switchers can change price display. Test price search words and dropdown prices in each currency mode.

Needs testing

Custom product fields

If your search depends on custom fields, custom taxonomies, or supplier data, test whether your expected data is indexed and shown.

Safe testing

How to check compatibility safely.

Do this before enabling every feature on a busy live store.

Before installing

  • Backup website files and database.
  • Use staging first for high-traffic stores.
  • Note your current cache plugins and Cloudflare settings.
  • Check that WooCommerce and Flatsome are working normally.
  • Prepare a few real product keywords to test.

After installing

  • Turn on safe design settings first.
  • Test desktop and mobile search.
  • Enable Fast Index and rebuild product list.
  • Clear object cache, page cache, and Cloudflare cache.
  • Test exact search, typo search, first-letter search, price search, and guided topics.
  • Create a Debug Report if anything looks wrong.
Backup first. Test on staging. Turn on one group at a time. Clear cache. Test again.
Compatibility FAQ

Simple compatibility questions.

Is FlatSearch.Pro only for Flatsome?

FlatSearch.Pro is built for Flatsome first. Some parts may work elsewhere, but the main target is Flatsome + WooCommerce.

Is Cloudflare required?

No. Cloudflare is optional. Only turn on Cloudflare Fast Search if your store already uses Cloudflare.

Do I need Redis or Object Cache Pro?

No. They are optional speed helpers. FlatSearch.Pro can still work without them.

Will it work with FlyingPress, WP Rocket, or LiteSpeed?

Usually yes, but test JavaScript delay, minify, and cache settings. If search does not open or type correctly, use Delay JS Search Protection or exclude search scripts from delay.

Will it work with image optimization plugins?

Usually yes. If dropdown images are broken or grey, turn on Better Search Images and Small Image Guard, regenerate thumbnails, and clear cache.

Will it work with custom product types?

Normal WooCommerce products are the best fit. Custom product types should be tested on staging because different plugins store product data differently.

Should I backup before installing?

Yes. Backup your website files and database before installing any plugin on a live WooCommerce store.

Ready to test compatibility?

Backup first, test safely, then turn on the features your store needs.

FlatSearch.Pro is strongest on Flatsome + WooCommerce stores, with optional Cloudflare, object cache, and speed plugin support when configured carefully.