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
Main theme target
Products, prices, images, stock
Optional fast search cache
Optional server memory boost
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 fitWooCommerce
Required for products, prices, product images, stock, and product results.
RequiredWordPress
Works as a WordPress plugin. Keep WordPress, WooCommerce, and Flatsome updated.
RequiredBackup first
Always backup website files and database before installing on a live store.
ImportantMinimum 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. |
Built for Flatsome first.
Many search plugins try to fit every theme. FlatSearch.Pro focuses on the Flatsome search experience.
Flatsome Theme
Designed for the default Flatsome live search box, mobile search popup, and WooCommerce product search flow.
Flatsome Child Theme
Usually fine, but custom child theme code can change search HTML, CSS, JavaScript, or AJAX behavior.
Other themes
Some features may work, but FlatSearch.Pro is not built as a generic search plugin for every WordPress theme.
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 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.
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. |
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.
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. |
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. |
Some store setups need extra testing.
Every WooCommerce store can be customized differently. Test these areas on staging when they apply to you.
Multilingual stores
WPML, Polylang, TranslatePress, or other translation tools can change product titles, URLs, and search data. Test each language.
Multi-currency stores
Currency switchers can change price display. Test price search words and dropdown prices in each currency mode.
Custom product fields
If your search depends on custom fields, custom taxonomies, or supplier data, test whether your expected data is indexed and shown.
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.
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.
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.
