Description
AI Search replaces WordPress and WooCommerce default search with AI that understands meaning, not just words. When shoppers search for “summer wedding dress”, “cozy winter sweater” or “outfit for a first date”, they find your products — even when none of those exact words appear in the title. Same store, same theme, same checkout. Nothing new for visitors to learn, nothing to configure to go live.
Same queries with AI Search, products found:
- ✅ “summer wedding guest dress” → Light midi wraps, pastel jumpsuits, formal linen sets
- ✅ “warm cotton sweater for winter” → Merino pullovers, cable knits, cashmere blends
- ✅ “outfit for a first date” → Blazers, tailored dresses, leather boots
- ✅ “cozy loungewear for weekends” → Oversized hoodies, joggers, cotton sweatpants
- ✅ “wireless headphones for running” → Sweat-resistant earbuds, sport-fit models
Not just WooCommerce. AI Search works on any WordPress site: blog posts, pages, documentation, directories, any public custom post type. Wherever visitors search, semantic matching finds what they meant.
Try it live before installing: wp-search.ai/demos runs this exact plugin on three sample stores. Type your own search, or a SKU, and see the traditional results next to the AI results, side by side:
- Clothing store – users describe an occasion, not a product name
- Bookstore – readers remember the theme, never the exact title
- Electronics – model codes and specs, where exact SKU matching has to win
- Live search dropdown – type in the box and watch results appear before you finish
Traditional Results First, AI Results After
AI Search never replaces the results your search already finds. It adds to them. Every search runs in three steps, in this order:
- Exact matches: a query that matches a product SKU or an exact product title is always the first result.
- Traditional keyword results: everything WordPress and WooCommerce search would normally find (products literally containing your search words) comes next, ranked by keyword relevance instead of publish date.
- AI results: only below those. Semantic matches are added: products that mean the same thing even when they use different words.
So if a user searches for something that literally exists on your site, they see exactly what they would see without the plugin, just better ordered. The AI layer only ever extends the results with products the traditional search missed. Installing AI Search will not change or hide the results your customers already find today.
Search As You Type
Two optional blocks bring live results to your site, without sending your visitors to a results page first:
- AI Search Box: a search field that shows results in a dropdown as the user types: thumbnail, product title and price on a single row.
- AI Search Button: a search icon for your header or menu that opens a full-screen search overlay.
Both are Gutenberg blocks. Open any page, template or header in the editor, click the + button, search for “AI Search”, and place the one you want – there is nothing to configure to get started.
They follow the same “traditional first” rule as the results page: keyword and SKU matches appear instantly on every keystroke, and AI suggestions are added underneath when typing pauses.
Try the live search demo – three real catalogues, type anything you like.
This keeps your quota intact. Keystrokes cost nothing, only the pause triggers a single AI lookup. A ten-character search runs one AI request, not ten.
Both blocks read your theme’s own colours, fonts and corner radius, so they look like part of your site rather than something bolted on, on light and dark themes alike. They are fully keyboard and screen-reader accessible. And they are entirely optional: place one where you want it, or place none and nothing about your site changes.
Key Features
- Search As You Type: Optional search box and search button blocks with a live results dropdown, keyword matches instantly, AI suggestions on pause.
- WooCommerce Product Search: Full product catalog indexing, titles, short and long descriptions, SKUs, categories, tags, and product attributes (size, color, material, etc.). Pre-configured defaults so you can go live in minutes.
- Understands Meaning, Not Just Keywords: Semantic search means “cozy winter sweater” matches your “merino wool pullover”. Long-tail and descriptive queries stop returning empty pages.
- Traditional Results Are Never Lost: Keyword matches always rank above AI suggestions. The AI extends your search results. It never replaces them.
- Cross-Lingual & Multilingual: Works with 100+ languages, Portuguese, Spanish, French, German, Greek, Arabic, Chinese, Japanese, and more. International stores get consistent search quality across every language, and an English query can still match content in other languages.
- SKU & Attribute Matching: Customers can search by SKU fragments, attribute values, or technical specs and still find the right product.
- Smart Fallback System: 4-tier fallback ensures users never hit a zero-result page, if AI search finds nothing, standard WordPress search takes over automatically.
- No External Account Needed: Our free service covers up to 10,000 products per site, out of the box.
- Advanced: Use Your Own Provider Key: Power users can bring their own provider key for unlimited indexing.
- One-Click Indexing: Index your entire existing catalog in one click, filtered by post type or category.
- Quota Management: Real-time monitoring of AI service usage and limits (v1.14.0+).
- Works Beyond Products Too: Same intelligent search for blog posts, pages, and any public custom post type.
- ACF Compatible: Index Advanced Custom Fields data for deeper product metadata search.
- Tunable Similarity Threshold: Fine-tune how strict or broad search results are, per store.
- Intelligent Caching: Fast results with automatic local caching.
AI Search Works With Any WooCommerce Store
- Fashion & apparel: “something flowy for a summer wedding” finds dresses; attribute-aware queries like “cotton breathable large” match by size and material
- Beauty & skincare: “my skin looks tired” finds night creams and recovery oils; “gift for sensitive skin” finds hypoallergenic sets
- Electronics: “wireless headphones for running” finds sweat-resistant earbuds; exact SKUs like
WOO-HOOD-24are always pinned first, no guessing - Home & garden: “cozy living room” finds rugs, lamps, throw pillows; “durable outdoor” finds weather-resistant furniture
- Food & beverage: “healthy snacks for kids” finds low-sugar options across your catalogue
- Books & media: readers remember themes, plots and moods, rarely exact titles: “coming-of-age novel set in Japan” finds what keyword search never would
- B2B & wholesale: semantic queries like “cotton shirts bulk order” work the same way; your existing WooCommerce pricing rules and role-based visibility still apply
- Knowledge bases & directories: long-tail help queries stop hitting empty pages; “how to reduce hosting costs” finds “cutting your server bill in half”
Works With The Plugins Your Store Already Uses
- WooCommerce: products, variations, virtual products, categories, tags, brand taxonomy, product attributes (size, color, material, etc.)
- ACF (Free and Pro): text, textarea, WYSIWYG, repeaters, and group fields; opt-in via the Custom Fields tab
- Meta Box, Pods, JetEngine: text fields exposed through standard WordPress meta APIs are picked up automatically; more via the
ai_search_embedding_contentfilter - WPML and Polylang: content is indexed separately per language, so a Portuguese query finds Portuguese products, not the English original
- Page builders: Gutenberg native. Elementor, Divi, Beaver Builder and Bricks content is indexed wherever it lands in
post_content - Any WordPress theme: the plugin extends your existing search template; no theme changes needed
How It Works
- Each product in your WooCommerce catalog is converted into a “meaning fingerprint” that captures its title, description, SKU, categories, tags, and attributes.
- When a user searches, the plugin first pins exact SKU/title matches, then lists every traditional keyword match (what your search finds today), ranked by relevance.
- The query then gets its own meaning fingerprint, which is compared against every product’s.
- The closest meaning matches are appended below the traditional results, extra products the keyword search missed, never replacements for it.
- If nothing at all is found, a multi-tier fallback kicks in so users never hit an empty results page.
Indexing happens automatically when you publish or update products, no manual work after setup.
Learn More
Visit our website for documentation, demos, and examples:
https://wp-search.ai/?utm_source=wordpress.org&utm_medium=readme
Browse technical documentation, see live demos of the plugin in action, and learn best practices for AI-powered search.
Usage
- Your existing WooCommerce search form (and the default WordPress search) are automatically upgraded, no theme or template changes required.
- Manage settings, switch providers, and monitor quota via the AI Search menu in your WordPress admin.
External Service
This plugin connects with:
- OpenAI Embeddings API: https://platform.openai.com/docs/guides/embeddings
- Custom Node.js Embedding Service
Please read more here:
https://platform.openai.com/docs/guides/embeddings
Installation
- Install and activate the plugin through the ‘Plugins’ menu in WordPress.
- The setup wizard launches automatically. If you have WooCommerce active, it will detect your store and pre-select the most useful product fields (short description, categories, attributes, SKU).
- Run Bulk Indexing from AI Search > Indexing to index your existing product catalog (or posts/pages).
- That’s it, new and updated products get indexed automatically from this point on.
FAQ
Can I migrate from Relevanssi, SearchWP, or FiboSearch?
Yes, and there is no migration to do. AI Search runs alongside your existing search plugin during testing. Install it, click Sync content in the setup screen, and the traditional results your current plugin provides continue exactly as before, AI results are added below them, never on top. If the AI layer doesn’t work for you, deactivate AI Search and your previous plugin keeps working as if nothing happened. Most stores test both in parallel for a week and decide.
How is AI Search different from SearchWP or Relevanssi?
Relevanssi and SearchWP are keyword-quality plugins. They rank keyword matches better than WordPress default (title weighting, stemming, relevance boosts). AI Search does something keyword search cannot do: it finds products that mean the same thing as the query even when they share zero keywords with it. “Cozy winter sweater” finds “merino wool pullover”. Relevanssi and SearchWP can’t, because no keyword overlaps. In practice, many stores that already run keyword-quality search still benefit from AI Search because it fills the long-tail: queries WordPress and its keyword extensions cannot match. AI Search never replaces existing keyword matches, only adds semantic matches below.
How is AI Search different from FiboSearch (Ajax Search for WooCommerce)?
FiboSearch focuses on live dropdown UX, great AJAX search-as-you-type, styled results panel. AI Search does both: an AI Search Box block with keyword matches on every keystroke plus AI semantic suggestions on pause, AND a semantic layer on the main results page. If you’re happy with FiboSearch’s dropdown, install AI Search without a block, you keep FiboSearch’s UI, and the results page silently picks up semantic matches. If you want a single-plugin setup, remove FiboSearch and place the AI Search Box block, same live dropdown experience, plus semantic ranking behind it.
How is AI Search different from Elasticsearch or Algolia setups?
Elasticsearch and Algolia are search infrastructure: you configure indexes, ranking rules, synonyms, typo tolerance, boost rules. Powerful. Also heavy, and typically needs a dedicated search team. AI Search is a drop-in semantic layer for stores that don’t have one: one-click sync from the plugin admin, no ranking rules to write, no index to manage. If you already run Elasticsearch or Algolia with a real search team, AI Search is probably not for you; if you have a WooCommerce store and want semantic search without hiring one, it is.
Is there a live demo?
Yes – four. wp-search.ai/demos runs the real plugin on a clothing store, a bookstore and an electronics store, each with its own catalogue. Type any query – your own words, an exact product name, or a SKU – and the page shows traditional search results and AI Search results side by side, each result labeled by tier. You can also drag the similarity threshold and watch the AI results change live.
There is also a live search demo for the dropdown: type into any of the three boxes and watch keyword matches appear as you type, with the AI suggestions joining when you pause. Nothing on any of these pages is staged.
How do I add the live search dropdown to my site?
The plugin ships two blocks. Edit any page, template or header in the block editor, click the + button and search for “AI Search”. Pick AI Search Box for a search field with a dropdown, or AI Search Button for a search icon that opens a full-screen overlay – the button works well in a site header. There is nothing to configure to get started, though you can turn thumbnails, prices and the result count on or off in the block sidebar. See both in action.
Do the search blocks use up my quota?
Barely. Every keystroke runs a keyword and SKU search, which costs nothing. Only when the user stops typing does the plugin make a single AI lookup. So a ten-character search costs one AI request, not ten – and repeated searches are served from a five-minute cache, costing nothing.
Do I have to use the blocks?
No. They are entirely optional. If you place no block, your site is untouched, no extra scripts load, and the plugin works exactly as it did before – improving the results page users reach after pressing Enter.
Will the search blocks match my theme?
Yes. They read your theme’s own colour palette, typography and corner radius settings rather than shipping a fixed design, so they look native on light and dark themes alike. If you use a block theme, you can also adjust spacing and alignment from the block editor as usual.
Will installing AI Search change the results my visitors already get?
No. Results your search already finds are kept and shown first: exact SKU/title matches, then every traditional keyword match (ranked by relevance instead of date). AI results are only added below them: extra content the keyword search missed. If a user searches for something that literally exists on your site, they will still find it, in the same or a better position.
How does category and tag matching work?
On top of indexing each product, AI Search also indexes every category, tag, and WooCommerce attribute term. At search time, each product gets a small boost from its best-matching term. The practical effect: a user searching “trainers” surfaces products tagged “Sneakers” even when no product description contains the word “trainers”. You can manage this on the Term Embeddings tab (opt out of specific taxonomies, bulk-index existing terms) and tune the boost strength via the slider on Search Configuration.
Cost note: each unique category or tag counts as one indexed item against your quota. A typical WooCommerce store has 50-500 unique terms, so the one-time cost is small. If you have an unusually large taxonomy (e.g., thousands of free-text tags), you can disable that specific taxonomy on the tab.
Can developers customize behavior via PHP hooks?
Yes. As of v1.25.0, AI Search exposes the following filters for developers:
ai_search_embedding_content: Modify the text sent to the AI provider when generating embeddings. Useful for injecting taxonomy names, stripping boilerplate, or normalizing terminology.ai_search_should_generate_embedding: Return false to skip embedding generation for specific posts. Useful for excluding drafts in certain categories or low-content posts.ai_search_query_before_embedding: Rewrite the user’s search query before it’s embedded. Useful for synonym expansion, spell correction, or locale-specific normalization.ai_search_similarity_threshold: Override the similarity threshold per-query or per-post-type. Useful for stricter matching on products vs. looser on blog content.ai_search_results: Re-rank or filter the final search results. Useful for boosting in-stock products, hiding restricted content, or injecting pinned results.ai_search_term_embedding_content: (v1.26.0) Customize the text fed to the AI provider when embedding a taxonomy term. Useful for injecting parent-term names, synonym hints, or stripping boilerplate from term descriptions.ai_search_exact_matches: (v1.27.0) Add or remove post IDs pinned to the top of results as exact lexical matches (SKU / title) before AI ranking. Useful for EAN/GTIN, supplier references, or brand codes.
Plus the existing ai_search_searchable_post_types filter. Code examples are included in the inline PHPDoc above each filter in the plugin source.
Does this work with WooCommerce products?
Yes, WooCommerce is the primary use case. The plugin indexes product titles, short and long descriptions, SKUs, categories, tags, and product attributes. When you activate the plugin on a store with WooCommerce, the setup wizard automatically prioritizes products and pre-selects the most useful product fields.
Can shoppers search by SKU?
Yes, and an exact or prefix SKU match is always returned first, regardless of the AI score. Random-looking codes like B08M5XDKFG carry no meaning for an AI model, so before the semantic step the plugin checks the query against product SKUs (including variation SKUs, which resolve to their parent product) and against exact product titles. Matches are pinned to the top with a green “Exact Match” badge for editors. Partial SKUs work when the query is a single token of 4+ characters (WOO-HOOD finds WOO-HOODIE, WOO-HOODIE-LOGO, …). SKUs are part of the indexed content too, so mixed queries (“black shoes SKU-2024”) still work.
Does it work with WooCommerce product attributes?
Yes. Attributes like size, color, material, and any custom attributes you configure are indexed as part of the product’s searchable content. Shoppers can search by attribute values (“large cotton”) and the plugin will match products with those attributes.
Does it index product variations?
The plugin indexes the parent product (including its attributes and description). Individual variation-level descriptions aren’t separately indexed, but since attributes like size and color are included in the parent, searches for variation-specific terms still surface the right product.
What is required to use AI Search?
Nothing. Our free service covers up to 10,000 products per site, out of the box. Power users can also bring their own provider key for unlimited indexing.
What happens if the AI service fails?
The plugin logs the error and falls back to WordPress default search automatically, so users never hit a broken search page.
When are products indexed?
Automatically, when you publish a post, page, or custom post type. You can also reindex individual items from the post editor, or bulk-reindex the whole catalog from the Indexing tab.
Will this slow down my website?
No. Indexing runs in the background when content is published, not during searches. Search results stay fast because the hard work is pre-computed and stored in your database.
How many products can I index with the free service?
Up to 10,000 per site. For unlimited usage, you can bring your own provider key.
Does this work with custom post types?
Yes! AI Search works with any public custom post type. You can select which post types to make searchable in the setup wizard or settings page.
Can I index custom fields (ACF, meta boxes)?
Yes! You can configure custom post meta fields to be included in the search index. This is perfect for ACF fields, custom taxonomies, and other metadata.
What is the similarity threshold?
The similarity threshold (0.1-1.0, displayed as 10%-100%) determines how closely search results must match the query. Higher values (70%-80%) give more precise results; lower values (30%-50%) return broader matches. The default is 30%, which is a good starting point for most sites, adjust down if users see too few results, adjust up if results feel loosely related.
What happens if AI Search finds no results?
AI Search has a smart 4-tier fallback system that ensures users always get results, falling back to WordPress default search if needed.
Can I use my own AI provider key?
Yes. The Advanced tab (AI Search > Advanced) lets you switch from our free service to your own provider key for unlimited indexing.
Is my search data private?
Yes. Search queries are processed through the AI service to generate matches but are not stored externally. All search results and indexed data are stored in your WordPress database.
Screenshots






Changelog
1.49.0
- New: Weekly insights email summary. Every Monday the admin email receives a one-page recap of the last seven days (searches, AI rescues, zero-results) with the top queries in each category. Can be turned off from the Insights tab, and a test-send button lets you preview the real thing before enabling.
- New: AI Search dashboard widget on wp-admin’s home screen. Mini three-tile summary (searches / rescued / zero results) plus the top three searches and top three no-results from the last week. Visible to anyone with edit_posts (editors / shop managers); each user can hide it via Screen Options.
- New: No-results content gap report. Searches that returned nothing are now recorded alongside AI rescues, and a new “Searches that returned nothing” panel on the Insights tab surfaces the queries that repeat most – the clearest signal of what your catalogue is missing.
- Improved: Native in-plugin Upgrade page. The wp-admin → Upgrade entry no longer loads an iframe to the public pricing site. Two plan cards render inline (styled to match wp-search.ai), with “Start 14-day free trial” buttons that hand off straight to Stripe Checkout. Checkout now starts with the admin email prefilled and carries
origin=wp_admin, site URL, site UUID and plugin version in its metadata, so abandoned-cart recovery emails from Stripe land in the right inbox and support can trace a checkout back to its install. - Cleanup: Sidebar submenu renamed from “Support Forum” to “Ask for help! Support”; the “Contact the Author” submenu item was removed (support belongs in one place).
1.48.4
- Fix: sites whose initial registration with the AI Search Service was blocked by an outbound firewall, a security plugin or a transient network timeout are now recovered automatically. The plugin reattempts the registration in the background on the next three
admin_inithits (spaced 15 minutes apart), so a merchant whose activation call was swallowed by Wordfence or a cold DNS no longer silently stays unconnected. After three failures a persistent notice on the plugin’s own admin screens prompts a manual reconnect. - Fix: installs that happened to share the same
get_site_url()as another install (two developers running onhttp://localhost:10008, a staging/production URL collision, a misconfigured multisite) were silently collapsed onto the same service record — same API token, same quota counters, same Fast Search cloud index. Each install now generates a per-install UUID on activation and sends it asX-Site-UUIDon every service call. The service treats(origin, site_uuid)as the composite identity, so colliding installs each get their own isolated record, token and cloud index. Legacy installs (any version before 1.48.4) keep working exactly as before.
1.48.3
- Fix: Fast Search now engages on the frontend search path for Standard and Pro merchants. A guard that resolved the plan via the quota manager class was skipping the semantic cloud path on every frontend request because the class was only loaded in wp-admin, silently falling back to the local cosine loop. Load the quota manager universally so the plan gate resolves correctly everywhere a search runs.
- Fix: nested fallback queries no longer re-enter the tier pipeline. When all three tiers returned nothing above the threshold, the enhanced fallback fired
get_posts({'s' => ...})which triggered another full semantic pass that often emptied again, looping until the request timed out. Inner queries now carry anai_search_skipflag that short-circuits the filter on re-entry.
1.48.2
- Copy tweaks on upgrade and trial callouts to reflect the current 14-day free trial on annual plans.
Older releases: every version going back to 1.0 is on the full changelog at wp-search.ai/changelog/.
