Title: AI Search for WooCommerce &#8211; Intelligent Product Search
Author: Samuel Silva
Published: <strong>17. 1. 2025</strong>
Last modified: 29. 8. 2026

---

Prohledat pluginy

![](https://ps.w.org/ai-search/assets/banner-772-250.png?rev=3660867)

![](https://ps.w.org/ai-search/assets/icon-256x256.png?rev=3253612)

# AI Search for WooCommerce – Intelligent Product Search

 Autor: [Samuel Silva](https://profiles.wordpress.org/samuelsilvapt/)

[Stáhnout](https://downloads.wordpress.org/plugin/ai-search.1.32.0.zip)

 * [Podrobnosti](https://cs.wordpress.org/plugins/ai-search/#description)
 * [Hodnocení](https://cs.wordpress.org/plugins/ai-search/#reviews)
 *  [Instalace](https://cs.wordpress.org/plugins/ai-search/#installation)
 * [Vývojáři](https://cs.wordpress.org/plugins/ai-search/#developers)

 [Podpora](https://wordpress.org/support/plugin/ai-search/)

## Popis

**AI Search for WooCommerce** makes your store’s search actually work. When a shopper
types „summer blue dress“ they find your „light cotton navy sundress“. When they
search „headphones for running“ they find your sweat-resistant wireless earbuds —
even if the word „running“ isn’t anywhere in the product description.

Default WooCommerce search matches keywords. AI Search matches _meaning_. It reads
your entire product catalog — titles, descriptions, SKUs, categories, tags, and 
attributes — and converts each product into a vector that captures what it actually
is. When a shopper searches, the plugin finds the closest matches by meaning, not
by exact word overlap.

The result: fewer empty search pages, more products surfaced for long-tail queries,
and shoppers who find what they wanted on the first try.

**Try it live before installing:** [wp-search.ai/demos](https://wp-search.ai/demos/)
runs this exact plugin on a sample store. Type your own search – or a SKU – and 
see the traditional results next to the AI results, side by side.

Also works with blog posts, pages, and any custom post type — so you can use the
same intelligent search across your whole site.

### 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:

 1. **Exact matches** — a query that matches a product SKU or an exact product title
    is always the first result.
 2. **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.
 3. **AI results** — only _below_ those, semantic matches are added: products that 
    mean the same thing even when they use different words.

So if a shopper searches for something that literally exists in your store, 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.

### Key Features

 * **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 Shoppers, 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 shoppers never hit a zero-
   result page — if AI search finds nothing, standard WordPress search takes over
   automatically.
 * **No OpenAI Account Required**: Uses our free embedding service (up to 10,000
   embeddings per site). Works out of the box for most stores.
 * **Bring Your Own API Key**: Optionally use your own OpenAI API key for unlimited
   indexing.
 * **Bulk Embedding Generation**: 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.

### Perfect For

 * **WooCommerce stores** with large or varied product catalogs
 * **Fashion & apparel** stores where shoppers describe products in their own words(„
   something flowy for summer“)
 * **Electronics & home goods** stores with complex technical specs and model numbers
 * **Books, media, and marketplaces** with thousands of titles
 * **International stores** selling in multiple languages
 * Membership sites, knowledge bases, and directories — any content-heavy WordPress
   site

### How It Works

 1. Each product in your WooCommerce catalog is converted into a numeric „meaning fingerprint“(
    called an embedding) that captures its title, description, SKU, categories, tags,
    and attributes.
 2. When a shopper searches, the plugin first pins exact SKU/title matches, then lists
    every traditional keyword match (what your search finds today), ranked by relevance.
 3. The query then gets its own meaning fingerprint, which is compared against every
    product’s fingerprint.
 4. The closest semantic matches are appended below the traditional results — extra
    products the keyword search missed, never replacements for it.
 5. If nothing at all is found, a multi-tier fallback kicks in so shoppers never hit
    an empty results page.

Embeddings are generated 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/**

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

## Snímky obrazovky

[⌊AI Search Dashboard - Configure search settings and similarity threshold⌉⌊AI Search
Dashboard - Configure search settings and similarity threshold⌉[

AI Search Dashboard – Configure search settings and similarity threshold

[⌊AI Search results on the frontend - Badge showing similarity score (visible to
admins only by default)⌉⌊AI Search results on the frontend - Badge showing similarity
score (visible to admins only by default)⌉[

AI Search results on the frontend – Badge showing similarity score (visible to admins
only by default)

## Instalace

 1. Install and activate the plugin through the ‚Plugins‘ menu in WordPress.
 2. 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).
 3. Run **Bulk Embedding Generation** from **AI Search > Generate Embeddings** to index
    your existing product catalog (or posts/pages).
 4. That’s it — new and updated products get indexed automatically from this point 
    on.

## Nejčastější dotazy

### Is there a live demo?

Yes. [wp-search.ai/demos](https://wp-search.ai/demos/) runs the real plugin on a
sample clothing store. 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. Nothing there is staged.

### 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 products the keyword search missed.
If a shopper searches for something that literally exists on your site, they will
still find it, in the same or a better position.

### How do „term embeddings“ improve search? (v1.26.0)

On top of the per-post embedding, AI Search now generates one embedding per taxonomy
term — every category, tag, and WooCommerce attribute term. At search time, each
post’s score gets an additive boost from its best-matching term. The practical effect:
shoppers searching „trainers“ surface products tagged „Sneakers“ even when no product
description contains the word „trainers“. You can manage this on the new **Term 
Embeddings** tab (opt out of specific taxonomies, bulk-generate embeddings for existing
terms) and tune the boost strength via the slider on **Search Configuration**.

**Cost note**: each unique taxonomy term consumes one embedding from your quota.
A typical WooCommerce store has 50–500 unique terms, so the one-time cost is small—
and because terms are shared across all your products, you embed each one only once.
If you have an unusually large taxonomy (e.g., thousands of free-text tags), you
can disable that specific taxonomy on the new 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 as of v1.27.0 an exact or prefix SKU match is always returned first, regardless
of the AI similarity score. Random-looking codes like `B08M5XDKFG` carry no meaning
for an embedding 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 remain
part of the embedding 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’s embedding, searches for variation-
specific terms still surface the right product.

### What is required to use AI Search?

Nothing if you use our free AI Search Service (up to 10,000 embeddings per site).
If you want unlimited indexing, you can use your own OpenAI API key.

### What happens if the embedding API fails?

The plugin logs the error and falls back to WordPress default search automatically,
so shoppers never hit a broken search page.

### When are embeddings generated?

Embeddings are automatically generated when you publish a post, page, or custom 
post type. You can also regenerate them manually from the post editor or bulk generate
them from the settings page.

### Will this slow down my website?

No. Embeddings are generated in the background when content is published, not during
searches. Search results are fast because they use pre-computed embeddings stored
in your database.

### How many embeddings can I create with the free service?

The free AI Search Service provides 10,000 embeddings per site. For unlimited usage,
you can use your own OpenAI API 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 stores — adjust down if shoppers 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.

### How do I change my AI provider?

Go to AI Search > General Settings and switch between the free AI Search Service
or your own OpenAI API key.

### Is my search data private?

Yes. Search queries are processed through the embedding API but are not stored externally.
All search results and embeddings are stored in your WordPress database.

## Recenze

![](https://secure.gravatar.com/avatar/1587a4bd9aa73818823dae1b661300f3f148e145df6ee441653fbd95b3741e5c?
s=60&d=retro&r=g)

### 󠀁[Works like a charm](https://wordpress.org/support/topic/works-like-a-charm-2460/)󠁿

 [nunomorgadinho](https://profiles.wordpress.org/nunomorgadinho/) 16. 5. 2026

Love the idea and the implementation. I’ll be using this more and more on all of
our Woo sites.

![](https://secure.gravatar.com/avatar/17c21ab369892c48214978f7eb3e881ac96571a3a06b3833cd54becc79058eb0?
s=60&d=retro&r=g)

### 󠀁[Great and easy-to-use search plugin](https://wordpress.org/support/topic/great-and-easy-to-use-search-plugin/)󠁿

 [diogofilipesousa](https://profiles.wordpress.org/diogofilipesousa/) 9. 3. 2026

I installed this plugin and I’m really happy with it! Setup was quick and easy, 
and everything worked smoothly. It’s a great way to improve search on a website 
without any complicated setup or the need to write any code. Overall, I definitely
recommend it. It makes it much easier for users to find what they’re looking for.

![](https://secure.gravatar.com/avatar/6f60ff4690856254ed0783403e5d91584022e70a35291285e93b80aa39704961?
s=60&d=retro&r=g)

### 󠀁[Excellent!](https://wordpress.org/support/topic/excellent-13964/)󠁿

 [jasonsiegel](https://profiles.wordpress.org/jasonsiegel/) 18. 6. 2025

Installed, added my OpenAI key, and it just worked. Search results are way more 
relevant than the default WordPress search. It actually understands what people 
are trying to find, even if the keywords don’t match exactly.

![](https://secure.gravatar.com/avatar/57bca50c31a838ae499da026d2e6785b4a76dec676171ccdf2bf7383caa9039b?
s=60&d=retro&r=g)

### 󠀁[Awesome in every possible way](https://wordpress.org/support/topic/awesome-in-every-possible-way-3/)󠁿

 [Pirenko](https://profiles.wordpress.org/pirenko/) 18. 6. 2025

This plugin adds a huge boost to WordPress‘ default search functionality. If you
want AI search without writing a line of code, this is hands down the best solution
I’ve found.

![](https://secure.gravatar.com/avatar/2b0d83a67eb7177fef74395848635d044d2bc9d74a890b181a2fe810638b61fb?
s=60&d=retro&r=g)

### 󠀁[Great tool to empower search in your business website](https://wordpress.org/support/topic/great-tool-to-empower-search-in-your-business-website/)󠁿

 [nunospot](https://profiles.wordpress.org/nunospot/) 12. 6. 2025 1 odpověď

I’ve found this plugin and I must say, it’s awesome. The AI search results feel 
a lot more relevant.Setup was super simple, just added my OpenAI API key and it 
worked right out of the box. No complicated settings or code needed. It’s a great
tool if you want to give your visitors a better experience and make it easier for
them to find what they need.Definitely recommend it! PS: Is there a plan to integrate
Gemini as well? Thank you

 [ Přečtěte si všech 5 recenzí ](https://wordpress.org/support/plugin/ai-search/reviews/)

## Autoři

AI Search for WooCommerce – Intelligent Product Search je otevřený software. Následující
lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

 *   [ Samuel Silva ](https://profiles.wordpress.org/samuelsilvapt/)

Plugin „AI Search for WooCommerce – Intelligent Product Search“ byl přeložen do 
1 jazyku. Děkujeme všem [překladatelům](https://translate.wordpress.org/projects/wp-plugins/ai-search/contributors)
za jejich pomoc.

[Přeložte “AI Search for WooCommerce – Intelligent Product Search” do svého jazyka.](https://translate.wordpress.org/projects/wp-plugins/ai-search)

### Zajímá vás vývoj?

[Prohledejte kód](https://plugins.trac.wordpress.org/browser/ai-search/), podívejte
se do [SVN repozitáře](https://plugins.svn.wordpress.org/ai-search/), nebo se přihlaste
k[ odběru protokolu vývoje](https://plugins.trac.wordpress.org/log/ai-search/) pomocí
[RSS](https://plugins.trac.wordpress.org/log/ai-search/?limit=100&mode=stop_on_copy&format=rss).

## Přehled změn

#### 1.32.0

 * **WooCommerce has its own tab again**: product field settings moved out of Content
   into a dedicated WooCommerce tab, shown only on stores.
 * **New store status panel**: at a glance, how many published products are indexed,
   how many have SKUs, how many variations exist, how many products are hidden from
   search by catalog visibility, and how many categories and tags are indexed – 
   each with a link to fix what is missing.
 * Actionable warnings instead of silence: if products have SKUs but the SKU field
   is not being indexed, or if nothing is indexed at all, the panel says so and 
   points you to the right screen.
 * **Field pickers are readable again**: the custom field and WooCommerce field 
   checkboxes are now a responsive card grid instead of CSS columns that flowed 
   items vertically – easier to scan, and they collapse to a single column on small
   screens.
 * **Better WooCommerce defaults**: product description, short description, SKU,
   categories and tags are now included out of the box. Fixes a mismatch where the
   settings screen showed defaults the indexer did not actually apply on stores 
   that never opened the tab – most importantly the SKU, which powers exact-match
   search.

#### 1.31.0

 * **New Insights tab**: see what shoppers searched for and which products they 
   were shown. Only searches where the AI surfaced results that exact and keyword
   matching had missed are recorded – so the list is a running record of the plugin
   earning its keep.
 * **Private by design**: no IP addresses, no user accounts, no cookies – just the
   query, the result counts per tier, and the top result IDs. Nothing that needs
   a consent banner.
 * Logging can be switched off, records are kept for a configurable window (30/90/
   180/365 days, default 90) and cleaned up automatically, and the whole log can
   be cleared with one button.
 * Writes happen after the page has been sent to the visitor, so logging never slows
   a search down.
 * Added `uninstall.php`: removing the plugin now cleans up its settings and the
   log table. Post and term embeddings are intentionally left in place so an accidental
   uninstall does not cost you your whole index.

#### 1.30.0

 * **Products found by their categories and tags**: search now also finds products
   whose _category or tag_ matches what you typed, even when the product’s own text
   does not. A shopper searching „trainers“ finds items tagged „Sneakers“; „running
   shoes“ finds them too. Until now those products could stay invisible because 
   their description never used your customer’s word.
 * Term-only matches are scored conservatively and can never outrank an exact SKU/
   title match or a strong content match – they are added to the results, never 
   in front of them.
 * New developer filter `ai_search_term_match_threshold` to tune (per taxonomy) 
   how close a term must be to the query before it pulls in its products.
 * Requires term embeddings to be enabled (Indexing tab) – already the default on
   WooCommerce stores.

#### 1.29.0

 * **Simpler, native admin**: the settings screens were rebuilt with WordPress core
   components – no more gradient panels, traffic-light sliders or invented color
   schemes. Clean white panels, standard notices, one clear explanation per setting.
 * **Five tabs instead of eight**: General (provider, connection and quota), Search(
   threshold and term boost), Indexing (post and term embeddings together), Content(
   custom fields and WooCommerce fields together), Tools (cache). Old tab links 
   keep working.
 * **Translations included**: full Spanish (es_ES), Portuguese (pt_PT) and French(
   fr_FR) translations of the admin interface ship with the plugin.
 * **Index status at a glance**: the Indexing tab now shows, per content type, how
   many published items are indexed and how many still need AI sync – e.g. „Products:
   14 of 18 indexed, 4 need sync“.
 * **Honest threshold copy**: the similarity threshold now explains what it actually
   does – it only affects AI results; exact and keyword matches always appear. The
   fake „interactive demo“ with invented products was removed; a note points to 
   the real threshold tester on your site’s search pages.

#### 1.28.1

 * **Fix: secondary search queries now get the full tiered treatment.** The plugin
   read the searched terms from the global query, so a `WP_Query` with its own `
   s` parameter (blocks, widgets, AJAX search handlers) was processed with the wrong–
   usually empty – terms: no exact-match pinning, no AI results, and a wasted embedding
   request for an empty string. The terms now come from the query being filtered.

#### 1.28.0

 * **Keyword Matches Always Shown Before AI Extras**: WordPress‘ own search results
   are no longer discarded when the semantic search finds something. Results now
   come in three tiers: exact SKU/title matches first, then every product that literally
   contains the search words (ordered by keyword relevance: title > content > taxonomies
   > custom fields, not by date), then semantic extras below. Fixes cases where 
   a product named „Beanie with Logo“ vanished from a „beanie“ search while a loosely-
   related product appeared.
 * Editors see a blue „Keyword Match“ badge on tier-two results; they carry the `
   ai-search-lexical-match` CSS class.
 * **Accurate Result Counts**: The „Showing all N results“ count shown by themes
   now matches the number of results the plugin actually returns.
 * **Simpler Settings: Hybrid Search Removed**: The Hybrid Search toggle and balance
   slider are gone. Keyword matching no longer needs configuring — it is always 
   on, as the guaranteed tier above semantic results. Existing `ai_search_hybrid_enabled`/`
   ai_search_hybrid_balance` options are simply ignored. One less thing to tune.

#### 1.27.0

 * **Exact SKU & Title Matches Always First**: Before running the semantic search,
   the plugin now checks the query against WooCommerce SKUs (exact and prefix, variations
   resolve to their parent product) and exact post titles. Matches are pinned to
   the top of results with score 1.0 — no setting, always on. Fixes searches for
   random-looking codes such as Amazon ASINs that scored below the similarity threshold.
   Editors see a green „Exact Match“ badge; results carry the `ai-search-exact-match`
   CSS class.
 * **New Developer Hook**: `ai_search_exact_matches` lets you add (EAN, supplier
   reference) or remove pinned exact matches.
 * **Visible Errors in Bulk Generation**: The Generate Embeddings tab now reports
   how many items succeeded or failed and _why_ — connection errors (cURL), rejected
   token, exhausted quota, service outage, unpublished or empty content — instead
   of always saying „generated“. Provider-level errors stop the run early so a bad
   token doesn’t burn the whole batch. The setup wizard shows the real error instead
   of always reporting „Daily quota hit“, and the per-post „Regenerate“ button reports
   the reason too. `AI_Search::generate_embedding()` now returns `true` or a `WP_Error`.
 * **Respects Search Visibility**: Products marked hidden / excluded from search
   in WooCommerce catalog visibility no longer appear in AI results, exact matches,
   or fallback tiers. Post types registered with `exclude_from_search` are skipped
   when no post type is specified.
 * **Fix: site-wide search never used AI ranking**: WordPress resolves a search 
   without an explicit post type to `post_type=any`; the plugin used that literal
   string in its SQL, so only searches scoped to a post type (e.g. the WooCommerce
   product search form) got semantic results — the generic site search always fell
   back to WordPress default matching. `any` is now expanded to all searchable public
   post types.
 * Tested up to WordPress 7.0.

#### 1.26.0

 * **Per-Term Semantic Embeddings**: AI Search now generates a separate embedding
   for each taxonomy term (category, tag, WooCommerce attribute term) in addition
   to the post-level embedding. At search time each post gets an additive boost 
   from its best-matching term — so a shopper searching „trainers“ surfaces products
   tagged „Sneakers“ even when no description mentions trainers. Default ON for 
   WooCommerce stores.
 * **New „Term Embeddings“ Settings Tab**: Toggle the feature, opt out of specific
   taxonomies (useful for huge tag taxonomies), and bulk-generate embeddings for
   terms that don’t have one yet. A status box shows X of Y terms indexed at a glance.
 * **Term Boost Slider**: New 0–50% slider on the Search Configuration tab controls
   how much a matching term boosts a post’s score. Default 20% — enough to widen
   recall without overpromoting tag-only matches.
 * **New Developer Hook**: `ai_search_term_embedding_content` lets you customize
   the text fed to the AI provider when embedding a term (parallel to `ai_search_embedding_content`
   for posts).

#### 1.25.0

 * **Developer Extensibility**: Five new PHP filter hooks for customizing search
   behavior without forking — `ai_search_embedding_content`, `ai_search_should_generate_embedding`,`
   ai_search_query_before_embedding`, `ai_search_similarity_threshold`, and `ai_search_results`.
   See the new „Developer Hooks“ FAQ for details.

#### 1.24.0

 * **Token Recovery**: When the AI Search Service no longer recognises your site’s
   token (e.g. after a service-side reset), the General settings tab now offers 
   a one-click „Reconnect with new token“ button. Quotas and usage limits are preserved—
   only the credential rotates. The follow-up connection check runs automatically
   so you see the live status immediately.

#### 1.23.1

 * **Bug Fix — Setup Wizard Final Step**: Fixed a „The link you followed has expired“
   error that blocked some users at the last step of the setup wizard on their first
   run. The CSRF nonce on the final-step form was failing verification in a subset
   of install scenarios; removed in favour of the capability check that was already
   in place.

#### 1.23.0

 * **WooCommerce-First Experience**: Repositioned for WooCommerce stores with tailored
   onboarding, product-priority defaults in the setup wizard, and a „store detected“
   welcome banner
 * **Multilingual Search Documented**: Confirmed and documented support for 100+
   languages including Greek, Arabic, Chinese, Japanese, and all European languages(
   semantic search path)
 * **Bug Fix — PHP 8 DivisionByZeroError**: Fixed a crash in cosine similarity when
   a stored embedding had zero magnitude (sqrt returns float 0.0, strict `=== 0`
   comparison was bypassing the guard)
 * **Test Suite Added**: First-time PHPUnit-based test harness (unit + integration
   suites) covering similarity math and the external service client
 * **Documentation Fix**: Corrected similarity threshold range in FAQ (0.1-1.0 since
   v1.18.0, previously documented as 0.5-1.0)

#### 1.22.0

 * **Domain Mismatch Detection**: Admin warning when site domain differs from the
   registered AI Search Service domain
 * **One-Click Reconnect**: Button to easily reconnect and get a new token for the
   current domain
 * **Automatic Origin Tracking**: Plugin now stores the registered origin for future
   mismatch detection
 * **Improved Migration Support**: Better handling when moving sites between domains(
   staging to production, domain changes)

#### 1.21.0

 * **Reusable CPT/Taxonomy Selector Component**: New shared UI component for Post
   Type, Taxonomy, and Term selection
 * **Clear Embeddings by Post Type/Taxonomy**: Delete embeddings for specific post
   types or taxonomy terms (not just all at once)
 * **Improved Cache & Clean Tab**: Added filtered clearing option alongside existing„
   Clear All“ functionality
 * **UI Component Architecture**: Introduced `components/` folder for reusable admin
   UI elements
 * **Code Refactoring**: Reduced code duplication between Generate Embeddings and
   Cache & Clean tabs
 * **Taxonomy/Category Filter for Embeddings**: Generate embeddings filtered by 
   specific categories or taxonomies (not just post types)
 * **Dynamic Taxonomy Loading**: Taxonomies and terms load dynamically via AJAX 
   based on selected post type
 * **Improved Generate Embeddings UI**: Cleaner form layout with loading states 
   and better UX

#### 1.20.0

 * **Performance Optimization for Large Sites**: Major improvements for sites with
   thousands of posts
 * **Batched Processing**: Posts are now processed in batches of 100 for optimal
   memory usage
 * **Search Results Caching**: Results are cached for 5 minutes to speed up repeated
   queries
 * **Direct Database Queries**: Optimized queries that fetch only necessary data
 * **Memory Management**: Automatic cleanup between batches to prevent memory exhaustion
 * **New Default Threshold**: Changed default similarity threshold from 65% to 30%
   for better out-of-box results
 * **Improved Threshold Guidelines**: Updated slider recommendations (30% now recommended
   as starting point)

#### 1.19.0

 * **Dedicated Admin Menu**: AI Search now has its own top-level menu in WordPress
   admin (no longer under Settings)
 * **Improved Menu Navigation**: Settings pages and Setup Wizard now correctly highlight
   the AI Search menu
 * **Contact the Author**: New submenu link to contact the plugin author directly
 * **URL Structure Update**: All admin URLs now use `admin.php?page=ai-search` for
   better WordPress integration

#### 1.18.0

 * **REST API Settings Endpoint**: New public endpoint at `/wp-json/ai-search/v1/
   settings` exposing plugin configuration for debugging (no sensitive data)
 * **OpenAI Model Selection**: Choose between `text-embedding-3-small` (default,
   recommended) and `text-embedding-3-large` when using your own OpenAI API key
 * **Extended Threshold Range**: Similarity threshold now supports 10-100% (previously
   50-100%) for broader search flexibility
 * **Updated Default Model**: OpenAI embeddings now use `text-embedding-3-small`
   instead of the older `text-embedding-ada-002`

#### 1.17.0

 * **Hybrid Search**: New feature combining AI semantic search with traditional 
   keyword matching for improved accuracy
 * **Search Configuration Tab**: Dedicated settings tab for fine-tuning search behavior(
   similarity threshold and hybrid search)
 * **Configurable Balance Slider**: Adjust the weight between AI semantic search(
   0-100%) and keyword matching
 * **Enhanced Keyword Matching**: Keyword scoring now includes custom fields and
   WooCommerce fields configured in settings
 * **Reusable UI Components**: New slider components for threshold and hybrid balance
   configuration
 * **Improved Search Accuracy**: Better ranking when exact keyword matches are important
   alongside semantic understanding

#### 1.16.0

 * **Automatic Embedding Generation on Publish**: Embeddings now generated automatically
   when posts/pages/custom post types are published
 * **Improved Performance**: Removed automatic embedding generation on every save–
   now only triggers on publish status transition
 * **Universal CPT Support**: Automatic embedding generation works seamlessly for
   all post types without additional configuration
 * **Post Meta Box Enhancement**: Content quality indicator and embedding preview
   available for published posts only
 * **Better Resource Management**: Reduced API calls by only generating embeddings
   when content is ready for public viewing
 * **Setup Wizard Updates**: Final step now includes similarity threshold configuration
   with better default value (0.65)
 * **Admin Interface Improvements**: Post Meta Box now provides clear status messages
   for unpublished posts
 * **Case-Insensitive Search**: All content and search queries converted to lowercase
   for consistent matching
 * **Enhanced Similarity Display**: AI Search badges now show percentage similarity
   scores on search results (editors/admins only)
 * **Fallback Search Improvements**: Fallback results now calculate and display 
   actual similarity scores instead of showing 0%
 * **Threshold Filtering on Fallback**: All fallback search strategies now respect
   the similarity threshold setting
 * **CSS Classes for Results**: Added `ai-search-similarity-{percentage}` CSS classes
   to all search results for custom styling
 * **Frontend Threshold Slider**: Admins can test different threshold values directly
   on search results pages

#### 1.15.0

 * **Enhanced Setup Wizard**: Expanded from 3 to 4 steps with new custom fields 
   configuration
 * **Custom Fields Step**: New dedicated wizard step for choosing searchable content
 * **Content Richness Emphasis**: Added messaging that „richer content = better 
   search results“
 * **Post Type Selection**: Choose which post types (posts, pages, custom types)
   are searchable during setup
 * **WooCommerce Field Configuration**: Configure product fields (SKU, categories,
   tags, attributes) in wizard
 * **Streamlined Admin Menu**: Simplified submenu to General Settings, Setup Wizard,
   and Support Forum link
 * **Direct Support Access**: Added WordPress.org support forum link directly in
   admin menu
 * **Improved Quota Display**: Quota tab now shows relevant message for users with
   their own OpenAI API key
 * **Better Onboarding Flow**: Setup wizard now guides users to configure content
   before generating embeddings
 * **Brazilian Portuguese Translation**: Added pt_BR translation file for readme

#### 1.14.0

 * **Quota Management Tab**: New dedicated tab showing real-time usage statistics
   from AI Search Service
 * **Usage Monitoring**: Visual progress bars displaying total embeddings and daily
   usage against limits
 * **Quota Status Indicators**: Clear status badges showing if quotas are active
   or exceeded
 * **Manual Refresh**: On-demand quota data refresh with intelligent 6-hour caching
 * **Detailed Error Messages**: Enhanced error handling with specific API error 
   messages
 * **Last Updated Timestamp**: Human-readable „last updated X ago“ display for quota
   data
 * **Quota Manager Class**: New dedicated controller class for quota management (
   separation of concerns)
 * **API Integration**: Direct integration with `/clients/quota` endpoint using 
   Bearer token authentication
 * **Internationalization**: All new quota strings fully translatable

#### 1.13.0

 * **Top-Level Admin Menu**: AI Search moved from Settings submenu to main WordPress
   admin menu (position 58, before Settings)
 * **Custom Menu Icon**: Added plugin icon (SVG) to admin menu
 * **Full i18n Support**: All admin settings pages now fully translatable
 * **Improved Admin UX**: Better visibility and professional appearance in WordPress
   admin

#### 1.12.0

 * **Automatic Service Registration**: Plugin now registers with AI Search Service
   immediately on activation
 * **Setup Wizard Redirect**: Users are automatically redirected to the setup wizard
   after plugin activation
 * **Simplified Settings UI**: Removed service token field from settings – connection
   is now managed automatically
 * **Check Connection Button**: Replaced „Validate Token“ with cleaner „Check Connection“
   button showing usage stats
 * **Streamlined Onboarding**: Better first-time user experience with automatic 
   configuration
 * **Code Cleanup**: Removed unused spelling suggestions and search highlighter 
   classes

#### 1.11.0

 * **Percentage-Based Threshold Display**: Similarity threshold now displays as 
   percentage (20-100%) instead of decimal (0.2-1.0) for easier understanding
 * **Public Badge Visibility Option**: New admin setting to show AI Search badge
   to all visitors, not just editors/admins
 * **Removed Analytics Feature**: Simplified plugin by removing search analytics
   dashboard and tracking
 * **Enhanced WooCommerce Documentation**: Improved readme with eCommerce-specific
   keywords and use cases
 * **Visual Improvements**: Redesigned similarity threshold section with prominent
   visual indicators
 * **No Emoji Policy**: Removed all emojis from admin interface for professional
   appearance
 * **Website Launch**: Added link to https://wp-search.ai for documentation and 
   demos

#### 1.10.1

 * **AI Search Result Badge**: Visual badge displayed on search results powered 
   by AI
    - Shows „AI Search Result“ label with plugin icon
    - Only visible to editors and administrators
    - Tooltip explains visibility restriction
 * **Similarity CSS Classes**: Added CSS classes to search result posts
    - `ai-search-result` class for AI-powered results
    - `ai-search-similarity-{0-100}` class with exact similarity percentage
    - `ai-search-match` class when result meets configured threshold
    - `ai-search-fallback` class for non-AI fallback results
 * **Removed Frontend Notices**: Removed the intrusive search feedback notices that
   were shown to all users
 * **Developer Enhancement**: Similarity scores accessible via static properties
   for theme customization

#### 1.10.0

 * **Search Analytics Dashboard**: Track and analyze search behavior
    - Log all search queries with result counts
    - Click-through tracking on search results
    - Popular queries and zero-result analysis
    - Time-based statistics and trends
    - CSV export functionality
 * **„Did You Mean?“ Spelling Suggestions**: Intelligent spelling correction
    - Vocabulary built from post titles and taxonomies
    - Levenshtein distance-based word matching
    - Cached suggestions for performance
 * **Search Term Highlighting**: Visual feedback in search results
    - Highlights matching terms in titles and excerpts
    - Customizable highlight colors via filters
    - Dark mode support

#### 1.9.2

 * **Version Consistency**: Fixed version mismatch between plugin header and internal
   constants
 * **Internationalization Ready**: Added text-domain ‚ai-search‘ and domain path
   for translation support
 * **Documentation Fix**: Corrected similarity threshold range documentation (0.2-
   1.0)
 * **Developer Filter**: Added `ai_search_searchable_post_types` filter to customize
   which post types are searchable

#### 1.9.0

 * **Enhanced Fallback Search System**: Introduced intelligent 4-tier fallback mechanism
   for zero-result searches:
    - WordPress default search fallback with result count display
    - Broader semantic search with relaxed similarity thresholds
    - Unprocessed content search for posts without embeddings
    - Smart query suggestion system for completely failed searches
 * **User Feedback Notifications**: Real-time search feedback system with dismissible
   notices:
    - Visual indicators showing which fallback method was used
    - Search result counts for transparency
    - Automatic cleanup of feedback transients
    - Contextual messaging for different search scenarios
 * **Interactive Threshold Demo**: Professional threshold demonstration interface:
    - Real-time product similarity visualization
    - Sample clothing store dataset with summer search scenario
    - Dynamic filtering based on threshold adjustments
    - Performance indicators showing recall rates and precision levels
    - Color-coded similarity scores and visual feedback
 * **Token Validation System**: Comprehensive service token management:
    - One-click token validation with detailed usage statistics
    - Real-time quota monitoring (daily/total limits)
    - Client information display including origin verification
    - Error handling for invalid or expired tokens
 * **Setup Wizard Enhancement**: Improved first-time user experience:
    - Step-by-step configuration process
    - Provider comparison with clear recommendations
    - Visual progress indicators and smooth transitions
    - Comprehensive completion flow

#### 1.8.0

 * **Service Token Management**: Added manual service token field in General Settings
   for better control and transparency
 * **Token Validation System**: New „Validate Token“ button with real-time validation
   and detailed usage statistics
 * **Enhanced Admin Interface**: Service token field automatically shows/hides based
   on provider selection
 * **Comprehensive Validation Results**: Displays client ID, origin, daily/total
   limits, current usage, and quota status
 * **Improved Error Handling**: Better error messages for token validation failures
   and connection issues
 * **User Experience Improvements**: Loading spinner, button states, and clearer
   user guidance
 * **Debugging Enhancements**: Added error logging for better troubleshooting and
   API response monitoring

#### 1.7.0

 * Major Performance & UX Improvements
 * Service Registration Optimization: Moved AI service registration from plugin 
   initialization to settings save, eliminating unnecessary API calls during normal
   page loads
 * Cache Management Tab: Added comprehensive cache management interface with three
   clearing options:
    - Clear embedding cache (transients) – safe regeneration
    - Clear post meta embeddings – requires manual regeneration
    - Clear all embedding data – complete reset option
 * Enhanced Similarity Threshold**: Improved precision and range:
    - Range changed from 0.0-1.0 to 0.2-1.0 (eliminates very low-relevance results
      while allowing broader searches)
    - Precision increased from 0.01 to 0.001 steps (3 decimal places)
    - Better user guidance and formatting
 * Modular Code Architecture: Refactored service registration into isolated, reusable
   methods for better maintainability
 * Real-time Cache Statistics: Display current cache size and post embedding counts
 * Enhanced Error Handling**: Better user feedback when AI service is unavailable
   with automatic fallback
 * Security Improvements: Enhanced nonce verification and user capability checks

#### 1.6

 * Replaced internal embedding storage with external service integration.
 * Token-based authentication per origin.
 * Restore original search in case there isn’t any AI results
 * Solve fatal errors in case the vectors don’t have the same size

#### 1.5

 * Bulk embedding generation based on custom number of posts

#### 1.4

 * **Settings UI Revamp**: Introduced **tabbed navigation** to separate „General
   Settings“ and „Generate Embeddings“ for better organization.
 * **Batch Embedding Generation**: Users can now trigger embedding generation **
   for up to 50 posts** at a time.
 * **Custom Post Type Selection**: A dropdown was added, allowing users to **choose
   which CPT** they want to generate embeddings for.
 * **Embedding Optimization**: Now only processes posts that **do not yet have embeddings**
   to **avoid redundant API calls** and **improve performance**.
 * **Security Enhancements**: Added **nonce verification** to protect settings updates.

This update significantly **improves usability**, **optimizes performance**, and**
gives users more control** over AI-powered search embeddings.

#### 1.3

 * **Similarity Threshold Control**: Added a **range input field** (0-1) in settings
   to allow users to adjust the similarity threshold dynamically.

#### 1.2

 * Cache Search embeddings, saved in transients for one day

#### 1.1

 * text-davinci-003 (deprecated) has been replaced bytext-embedding-ada-002 model
 * db manipulation has been replaced by custom_post_meta approach

#### 1.0

 * Initial release, adding the settings page and the search filter.

## Meta

 *  Verze **1.32.0**
 *  Poslední aktualizace **před 23 hodin**
 *  Aktivních instalací **80+**
 *  Testováno až do WordPressu **7.1**
 *  Verze PHP ** 8.0 nebo novější **
 *  Jazyky
 * [English (US)](https://wordpress.org/plugins/ai-search/) a [Portuguese (Portugal)](https://pt.wordpress.org/plugins/ai-search/).
 *  [Přeložte do vašeho jazyka](https://translate.wordpress.org/projects/wp-plugins/ai-search)
 * Štítků
 * [AI](https://cs.wordpress.org/plugins/tags/ai/)[ecommerce](https://cs.wordpress.org/plugins/tags/ecommerce/)
   [product search](https://cs.wordpress.org/plugins/tags/product-search/)[semantic search](https://cs.wordpress.org/plugins/tags/semantic-search/)
   [woocommerce](https://cs.wordpress.org/plugins/tags/woocommerce/)
 *  [Podrobnosti](https://cs.wordpress.org/plugins/ai-search/advanced/)

## Hodnocení

 5 z 5 hvězdiček.

 *  [  5 5hvězdičkové hodnocení     ](https://wordpress.org/support/plugin/ai-search/reviews/?filter=5)
 *  [  0 4hvězdičkové hodnocení     ](https://wordpress.org/support/plugin/ai-search/reviews/?filter=4)
 *  [  0 3hvězdičkové hodnocení     ](https://wordpress.org/support/plugin/ai-search/reviews/?filter=3)
 *  [  0 2hvězdičkové hodnocení     ](https://wordpress.org/support/plugin/ai-search/reviews/?filter=2)
 *  [  0 1hvězdičkové hodnocení     ](https://wordpress.org/support/plugin/ai-search/reviews/?filter=1)

[Vaše hodnocení](https://wordpress.org/support/plugin/ai-search/reviews/#new-post)

[Zobrazit všechny recenze](https://wordpress.org/support/plugin/ai-search/reviews/)

## Spolupracovníci

 *   [ Samuel Silva ](https://profiles.wordpress.org/samuelsilvapt/)

## Podpora

Vyřešené problémy během posledních dvou měsíců:

     2 z 2

 [Fórum podpory](https://wordpress.org/support/plugin/ai-search/)