Configure faster, smarter WooCommerce search.
This guide explains how to configure FlatSearch.Pro’s search engine, Fast Index, search accuracy, caching, product discovery, images and commerce actions.
The current architecture supports the deeply optimized Flatsome integration and a theme-independent FlatSearch.Pro search surface for WooCommerce.
Current search architecture
Core requirements versus optional acceleration.
Five steps to a production-ready search.
Start with the core search path first. Add optional cache and presentation features after search results are correct.
Choose the search surface
Keep the optimized Flatsome integration or use FlatSearch.Pro’s universal WooCommerce search form / icon.
Enable Fast Index
Build the prepared product index, then use the rebuild tool once to generate current commerce-search data.
Enable search accuracy
Start with Better Word Matching, Typo Fix and the multi-word / first-letter capabilities appropriate for your catalogue.
Add optional acceleration
Cloudflare Fast Search and persistent object cache can improve repeat and high-traffic search performance.
Validate in Incognito
Test exact, typo, multi-word and repeat searches on desktop and mobile before considering the configuration finished.
Change one layer at a time.
Search correctness first. Then measure caching, frontend optimization and optional features separately.
One canonical search contract. Multiple acceleration layers.
FlatSearch.Pro no longer needs a different search meaning for each speed mode. Browser memory, shared cache, Cloudflare and Fast Index accelerate the same commerce-search contract.
Instant UI
Available local/browser data can paint immediately while the canonical search settles.
Browser Cache
Repeated queries may be reused locally without another full search round trip.
Shared / Edge Cache
Public query responses can be reused across visitors when valid.
Fast Index
The prepared WooCommerce search index answers uncached origin queries.
Safe Fallback
Compatibility paths remain available when an optional acceleration layer is unavailable.
Settled-query coordination
Transient typing can be coalesced so the browser does not need a full network search for every prefix.
No deliberate aborts
Once a canonical request has started, the current runtime can let it finish while stale-response guards prevent old results from repainting the current query.
One search meaning
Speed layers are designed to accelerate search without creating a different relevance definition for cached and uncached requests.
Know what good performance looks like.
These figures are measurements from our production test environment. They are useful diagnostic references, not guaranteed latency for every hosting configuration.
FlatSearch.Pro can provide its own WooCommerce search surface.
The original Flatsome integration remains deeply optimized, but the search UI is no longer limited to Flatsome’s native search component.
Universal Search Form
Renders a FlatSearch-owned WooCommerce search form where required.
[flat_search_pro_form]
Universal Search Icon
Adds a compact FlatSearch-owned search icon / modal trigger.
[flat_search_pro_icon]
Speed settings and acceleration layers.
These settings reduce repeated PHP, database, network or browser work. Not every store needs every layer.
Fast Index Engine
Builds prepared WooCommerce search data so uncached searches can avoid expensive general-purpose catalogue work.
- Recommended for most stores.
- Rebuild after relevant catalogue/index changes.
- Especially useful for medium and large catalogues.
Cloudflare Fast Search
Allows public search responses to be reused at Cloudflare where the store’s infrastructure supports it.
- Optional — not required for core search.
- Best value comes from repeated public queries.
- Use DevTools to distinguish HIT from MISS.
Browser Quick Search
Reuses suitable previously seen result data in the shopper’s browser so repeated interactions can appear faster.
- Useful for repeated searches.
- Does not require Cloudflare.
- Should preserve the same search result contract.
Memory Cache Boost
Uses a persistent object cache such as Redis when available to reduce repeated server-side work.
- Optional.
- Useful on busy WooCommerce stores.
- Not required for search correctness.
Product List Memory
Keeps useful product-search data ready for low-latency result presentation and compatible fallback behavior.
Instant Result
Helps FlatSearch.Pro display useful search results immediately while authoritative search transport remains coordinated behind the interface.
Repeated Search Cache
Reuses valid results for commonly repeated normalized search terms.
Slow Search Cache
Stores selected expensive search responses so an unusually slow query does not necessarily require the same work every time.
Search Cache Warm-Up
Can prepare selected common search terms in the background.
- Use selectively.
- Avoid warming large numbers of random queries.
- Requires healthy scheduled task execution.
Product Result Preload
Can prepare selected product navigation after search without aggressively waking every product-page resource.
- Use safe HTML-oriented behavior.
- Avoid redundant preload from multiple plugins.
- Do not preload large sets of product images unnecessarily.
Database Speed Check
Helps confirm that the store has the expected database/index support for efficient product search.
Search Results Page Cache
Caches the full submitted search-results page separately from the small live autocomplete request.
Help shoppers find what they mean.
These modules improve search interpretation while keeping one consistent relevance contract across supported speed paths.
Better Word Matching
Improves matching for product names containing multiple meaningful words and product-family terms.
- Useful for long product titles.
- Exact matches should remain strong.
- Works with Fast Index search.
Typo Fix
Helps common misspellings reach the intended product or brand without requiring perfect spelling.
- Example: civas → Chivas.
- Useful for difficult brand names.
- Exact queries should not be weakened by typo logic.
Multi-Word Matching
Coordinates searches containing several words so important terms can contribute together instead of behaving like unrelated queries.
Price Search Words
Lets shoppers use natural budget phrases such as:
- whisky under 300
- wine above 100
- between 100 and 250
Search From First Letter
Can begin useful discovery from short prefixes while the canonical network request remains coordinated.
Page & Blog Search
Allows relevant published pages or posts to appear alongside commerce search where enabled.
- Useful for guides and help content.
- Product results remain important for commerce queries.
Make fast search look fast too.
Perceived speed depends on result presentation, images and interaction — not only server timing.
Search Box Design
Applies FlatSearch.Pro’s result presentation including search rows, prices, popular/recent terms, View More and supported mobile presentation.
Better Search Images
Chooses search-appropriate WooCommerce image URLs rather than unnecessarily using oversized source images.
Small Image Guard
Helps prevent unsuitable, oversized or broken thumbnail choices from degrading the search dropdown.
Viewport Image Admission
The current frontend prioritizes images actually visible inside the dropdown viewport while off-screen result images remain deferred.
- Visible thumbnails can start together.
- Off-screen rows do not need immediate image requests.
- Scrolling admits newly visible rows.
Background Dimmer
Dims surrounding page content where supported so attention remains on the search experience.
Popular & Recent Searches
Shows useful discovery terms before or around search activity and supports the View More search journey.
Mobile Keyboard Helper
Helps supported mobile search surfaces focus the input and bring up the keyboard when necessary.
Cloudflare Image Resizing
Optional image-transformation support for stores that intentionally use Cloudflare Image Resizing.
Search can move beyond discovery.
FlatSearch.Pro can expose shopping actions and guided product recommendations directly inside the search experience.
Quick Add
Eligible products can expose Add to Cart actions directly from search.
- Optional module.
- Static assets load conditionally.
- Test special product types separately.
Guided Answer Search
Shows curated answer cards and associated products for selected search topics.
- Store-controlled content.
- Can recommend real WooCommerce products.
- Supports product selection and cart actions.
Search Page Sorting
Controls how the full WooCommerce search-results page prioritizes available and relevant products after submission.
Curated answers that lead to real products.
Guided Answer Search is store-controlled content rather than an uncontrolled live AI response.
| Store | Guided Answer | Example products |
|---|---|---|
| Drinks | Cocktail recipe or gifting guide | Spirit, mixer, garnish, glassware |
| Beauty | Beginner skincare routine | Cleanser, serum, moisturizer |
| Electronics | Gaming setup guide | Keyboard, mouse, headset, monitor |
| Fashion | Travel outfit guide | Shirt, pants, shoes, bag |
| Home | New-home starter kit | Bedding, towels, kettle, storage |
Full results-page settings.
These controls apply after the shopper presses Enter or chooses View More.
Search Cleanup Mode
Reduces unrelated work during supported search-result requests where it is safe to do so.
Search Page Sorting
Helps prioritize suitable and available products on the submitted search-results page.
Dropdown Result Limit
Controls how many autocomplete results are returned for a settled query.
Recent Search Limit
Keep recent-term presentation compact. Use 0 to disable it or a small number such as 3–8.
Voice Search
Adds a microphone control where supported so shoppers can speak a search query instead of typing.
- Browser/device capability varies.
- Useful for mobile interaction.
- Keep disabled if the store does not need voice input.
Delay JS Search Protection
Helps preserve search usability when a performance plugin delays JavaScript execution.
- Relevant to WP Rocket and similar optimizers.
- Validate after changing JS-delay settings.
- Do not exclude scripts unnecessarily when everything already works.
Let performance tools accelerate FlatSearch.Pro — not redefine it.
| Layer | Requirement | Guidance |
|---|---|---|
| Cloudflare | Optional | Useful for shared edge search caching. Core Fast Index search does not depend on Cloudflare. |
| Redis / Object Cache Pro | Optional | Useful for persistent server caching but not required for search correctness. |
| WP Rocket | Compatible with validation | Re-test search after changing JavaScript delay, cache or asset optimization settings. |
| Other JS optimizers | Validate | Aggressive script removal, combination or delay can affect any interactive search product. |
| Server/page cache | Generally compatible | Purge after relevant FlatSearch.Pro frontend updates to avoid stale asset references. |
Tools, diagnostics and reporting.
Admin Status
Quickly inspect active search modes, index readiness and important FlatSearch.Pro state.
Search Analytics
Review popular queries and search behavior to understand customer demand and discovery gaps.
Debug Report
Collects useful environment, module and search-readiness details for diagnosis.
Clear Cache
Use cache clearing after relevant search/index changes rather than purging everything repeatedly without reason.
Practical starting points by store type.
| Store | Recommended starting point | Reason |
|---|---|---|
| Small catalogue | Fast Index, Search Box Design, Better Search Images, Better Word Matching, Typo Fix | Strong relevance and presentation without requiring every optional cache layer. |
| Medium WooCommerce store | Fast Index, Instant Result, Browser Quick Search, Repeated Search Cache | Balances quick first interaction with repeat-query efficiency. |
| Large catalogue | Fast Index, persistent object cache, optional Cloudflare Fast Search, targeted warm-up | Reduces repeated origin work and improves high-volume search reuse. |
| Content-heavy store | Page & Blog Search, Guided Answer, Fast Index | Allows commerce and useful editorial content to participate in discovery. |
| Theme-independent deployment | Universal search form/icon + Fast Index + normal accuracy modules | Uses FlatSearch.Pro’s own search surface rather than requiring a theme-native autocomplete component. |
Test FlatSearch.Pro like a shopper and like an engineer.
The best configuration is the one that produces correct results, clean browser behavior and good perceived speed on the actual store.
Test relevance
- Full product name
- Brand or product family
- SKU where applicable
- Multi-word query
- Common typo
- Price-intent query
Test canonical transport
- Open browser DevTools → Network.
- Type a representative query.
- Look for the canonical /fsp-search.js request.
- Confirm there is no unnecessary per-character network storm.
- Confirm there are no red cancelled FlatSearch search rows.
Test cold versus warm
- Use Incognito for a clean first-load test.
- Check Cloudflare HIT / MISS where enabled.
- Repeat the exact same query.
- Do not compare a cold MISS directly with a browser-cached repeat.
Test viewport thumbnails
- Visible search images should appear quickly.
- Hidden off-screen rows should not require every thumbnail immediately.
- Scroll and confirm newly visible images load correctly.
- Watch for duplicate transformations or broken CDN URLs.
Diagnose the layer that is actually slow or incorrect.
Search accuracy, PHP origin time, Cloudflare cold fill, browser cache and product images are different layers. Avoid changing the ranking engine to solve an image or CDN problem.
Search shows “No products found” too early.
Fast Index results look different from expected search results.
I see many /fsp-search.js requests while typing.
I see red cancelled FlatSearch requests in DevTools.
Search is approximately 30–50 ms when warm but much slower after cache clear.
Search images are loading too many requests.
Search images are grey, missing or broken.
WP Rocket optimization causes search problems.
After changing settings, the frontend still behaves like the old version.
WordPress shows a critical error.
When should I capture a HAR?
Clean Uninstall
Decide whether FlatSearch.Pro data should remain available if the plugin is removed.
Remove stored plugin data
Clean Uninstall can remove FlatSearch.Pro options, index data and associated plugin storage during deletion.
Send the search evidence, not just the symptom.
A FlatSearch.Pro Debug Report plus an Incognito HAR can show the active search modules, canonical request, cache state, images and browser-visible timing.