Title: AI Vector Search (Semantic)
Author: eastercow
Published: <strong>Kanama 25, 2025</strong>
Last modified: Werurwe 27, 2026

---

Search plugins

![](https://ps.w.org/ai-vector-search-semantic/assets/banner-772x250.png?rev=3446233)

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

# AI Vector Search (Semantic)

 By [eastercow](https://profiles.wordpress.org/calingrim/)

[Download](https://downloads.wordpress.org/plugin/ai-vector-search-semantic.1.0.2.zip)

 * [Details](https://kin.wordpress.org/plugins/ai-vector-search-semantic/#description)
 * [Reviews](https://kin.wordpress.org/plugins/ai-vector-search-semantic/#reviews)
 * [Development](https://kin.wordpress.org/plugins/ai-vector-search-semantic/#developers)

 [Support](https://wordpress.org/support/plugin/ai-vector-search-semantic/)

## Description

**Stop losing customers to poor search results.** AI Vector Search transforms your
WooCommerce store’s search experience with intelligent, AI-powered technology that
understands what your customers are really looking for – not just matching keywords.

Whether you run a small boutique or manage thousands of products, this plugin delivers
lightning-fast, highly relevant search results that increase conversions and improve
customer satisfaction.

### 🚀 Why AI Vector Search?

Traditional WooCommerce search fails when customers use different words, misspellings,
or partial product codes. Our plugin solves this with three powerful search modes
you can choose based on your needs:

**Lite Mode (Default – Free Forever)**
 Works instantly after installation with 
zero configuration. Uses advanced TF-IDF algorithms with synonym expansion and stopword
filtering. Perfect for stores under 1,000 products or budget-conscious merchants.
No external services, APIs, or monthly costs required.

**Self-Hosted Supabase Mode**
 Unlock enterprise-grade search on your own infrastructure.
Get PostgreSQL full-text search combined with optional AI semantic understanding
via OpenAI embeddings. Your data stays in your Supabase project – you maintain complete
control. Includes partial SKU/EAN/UPC/ISBN matching, hybrid search strategies, and
scales to millions of queries. Free tier supports 50,000 queries/month.

**Managed API Service Mode**
 Let us handle everything. Simply activate with your
license key and we manage the entire stack – Supabase hosting, OpenAI integration,
infrastructure updates, scaling, and maintenance. You focus on your store, we handle
the complex search infrastructure.

### ✨ Powerful Features That Drive Sales

**Intelligent Search Technology:**
 * **Semantic Understanding** – AI knows “running
shoes” and “jogging sneakers” mean the same thing * **Fuzzy Matching** – Handles
typos and misspellings gracefully * **Autocomplete Suggestions** – Show matching
products, suggested search phrases, and category links while customers type * **
Partial Query Matching** – Finds relevant products even when shoppers type incomplete
multi-word searches * **SKU & Product Code Search** – Find products instantly by
partial EAN, UPC, ISBN, or SKU * **Hybrid Search** – Combines full-text, semantic,
and code-based search for best results * **Lightning Fast** – Search happens on 
optimized PostgreSQL infrastructure, not your WordPress server

**AI-Powered Recommendations:**
 * **Similar Products** – Automatically suggest 
related items on product pages using AI similarity * **Smart Cart Upsells** – Show
intelligent recommendations based on what’s already in the cart * **Multiple Display
Options** – Use shortcodes, Gutenberg blocks, or Elementor widgets anywhere on your
site * **Category-Aware** – Recommendations understand product relationships and
categories

**Search Analytics Dashboard:**
 * Track search volume, success rates, and click-
through rates * Identify popular search terms to optimize inventory * Get alerted
when customers search for products you don’t stock yet * Export analytics data for
deeper analysis * Make data-driven merchandising decisions

**Professional Setup & Management:**
 * **WP-CLI Commands** – Professional schema
installation, testing, and product sync via command line * **Auto-Sync** – Products
automatically sync when saved or updated * **Batch Processing** – Handle large catalogs
efficiently with intelligent batching * **Selective Field Sync** – Refresh cost,
price, and stock fields across synced products without re-syncing the full catalog***
Health Monitoring** – Built-in status checks and diagnostics * **Encrypted Security**–
API keys stored with enterprise-grade encryption and master key support

**Seamless Integrations:**
 * **Woodmart Theme** – Native integration with Woodmart’s
live search * **Elementor** – Drag-and-drop cart recommendations widget * **Gutenberg**–
Native blocks for easy content integration * **Developer Friendly** – Comprehensive
hooks and filters for customization

### 🎯 Perfect For

 * Stores frustrated with default WooCommerce search limitations
 * Large catalogs (1,000+ products) needing better discovery
 * Stores with complex product variations and attributes
 * Multi-language or international stores
 * Merchants wanting to increase average order value with smart recommendations
 * Developers seeking modern, scalable search infrastructure

### 🔒 Security & Transparency

**Your Data, Your Control:**
 All API keys are encrypted in your WordPress database.
Self-hosted mode keeps your product data in your own Supabase project. The Managed
API mode processes your data securely in isolated environments. All communications
use HTTPS/TLS encryption.

**Transparent Pricing:**
 * **Lite Mode:** Free forever, runs locally * **Self-Hosted
Supabase:** Free tier includes 50,000 queries/month. Optional OpenAI embeddings 
cost ~$0.05-$1.00 per 1,000 products (one-time setup cost only) * **Managed API 
Service:** Subscription-based pricing includes all infrastructure costs

**No Data Lock-In:**
 You always maintain access to your product data. Switch modes
or export your data anytime.

### 🏆 What Makes This Different?

Unlike other search plugins that require expensive third-party subscriptions or 
complex setups, AI Vector Search gives you complete flexibility. Start free with
Lite Mode, upgrade to self-hosted infrastructure when you grow, or let us manage
everything with the API service. You choose the approach that fits your business
model and budget.

Built by developers for developers, with comprehensive documentation, WP-CLI support,
and extensibility via WordPress hooks and filters.

### 📦 Installation

### Quick Start (5 Minutes)

 1.  **Install & Activate** the plugin from WordPress admin or upload manually.
 2.  **Use Lite Mode instantly** – search works locally out of the box. Visit **AI 
     Vector Search -> Settings** to adjust Lite stopwords, synonyms, or index limits
     if you need to tune results.
 3.  **(Optional) Connect Supabase for self-hosted search:**
 4.   * Create a free account at [supabase.com](https://supabase.com) and start a new
        project.
      * Copy your project URL and service key into the plugin settings.
      * Run the built-in schema installer from the admin UI or WP-CLI.
 5.  **(Optional) Enable Semantic Search with OpenAI:**
 6.   * Add your OpenAI API key to generate embeddings (self-hosted or API modes).
      * Choose the search mode that fits your catalog and budget.
 7.  **(Optional) Run a product sync** from **AI Vector Search -> Sync Products** or
     with `wp aivs sync-products` when using Self-Hosted Supabase or Managed API mode.
 8.  **(Optional) Enable Search Autocomplete** in settings to show product suggestions,
     matching terms, and categories in frontend search dropdowns.
 9.  **(Optional) Run a field-only sync** from **AI Vector Search -> Sync Products**
     when you need to refresh prices, stock, or cost values without a full catalog 
     sync.

### Command Line Tools (WP-CLI)

Speed up setup and maintenance with new WP-CLI commands (requires the PostgreSQL
client and, for schema installs, the encrypted connection string saved in settings):
*`
wp aivs install-schema` – install or update the Supabase schema from your WordPress
server. * `wp aivs check-schema` – verify tables, functions, and extensions are 
present. * `wp aivs test-connection` – confirm credentials before running migrations.*`
wp aivs sync-products` – batch sync products after catalog changes.

The Sync Products screen now supports browser-driven full catalog sync in configurable
batches, with live progress feedback to avoid admin page timeouts on larger stores.
It also includes field-only batch sync for `cost_price`, `regular_price`, `sale_price`,`
stock_quantity`, and `stock_status`.

You can also trigger schema installation from the admin UI; both paths use the encrypted
PostgreSQL connection string you store under **Settings AI Supabase**.

### Getting Your API Keys

**Supabase:**
 1. Visit [app.supabase.com](https://app.supabase.com) 2. Go to Project
Settings  API 3. Copy your project URL and service role key

**OpenAI (Optional for Semantic Search):**
 1. Visit [platform.openai.com/api-keys](https://platform.openai.com/api-keys)
2. Create a new API key 3. Ensure billing is set up for embedding API usage

### 📸 Screenshots

 1. Dashboard notice showing new WP-CLI support and quick setup actions.
 2. Settings menu entries added by AI Vector Search (Search Analytics, Supabase Status,
    Sync Products).
 3. Search Analytics dashboard with success rate, CTR, and popular search terms.
 4. Main plugin settings page with Supabase and OpenAI configuration, plus toggles 
    for live search integration and search autocomplete.
 5. Status page showing store health overview and configuration summary.
 6. Sync Products page with browser-driven batch progress, full sync controls, field-
    only sync actions, and embeddings generation options.
 7. Frontend autocomplete dropdown showing product matches, suggested terms, category
    links, and a view-all-results action.
 8. Setup guide for manual and WP-CLI installation, including PostgreSQL connection
    and OpenAI configuration.

### ❓ Frequently Asked Questions

#### What are the connection modes?

Lite mode runs locally and is enabled by default. Switch to self-hosted Supabase
when you want scalable vector search on your own infrastructure, or activate the
managed API service with your license key when you prefer a fully hosted stack. 
You can change modes in **Settings AI Supabase** and the plugin will guide you through
any extra steps (keys, schema install, or product sync).

#### When should I use each connection mode?

 * **Lite Mode** – Best for: small stores (<1000 products), budget-conscious merchants,
   or testing the plugin
 * **Self-Hosted Supabase** – Best for: full control, larger catalogs, semantic 
   search, international stores

#### Can I switch connection modes later?

Yes! You can switch between Lite, Self-Hosted, and Managed API modes at any time
from Settings. Your search analytics are preserved, but you’ll need to re-sync products
when switching to Self-Hosted Supabase or Managed API mode.

#### Is OpenAI required?

No! The plugin works great with just Supabase for fast keyword search. OpenAI is
only needed for semantic (AI) search and enhanced recommendations. You can start
with keyword search and add semantic features later.

#### How much does it cost to run?

**Supabase:** Free tier includes 50,000 monthly queries – perfect for most stores.
Paid plans start at $25/month for high-traffic sites.

**OpenAI:** One-time embedding cost of ~$0.05-$1.00 per 1,000 products. After initial
setup, ongoing costs are minimal (only for new products).

#### Will this slow down my site?

No! Search queries run on Supabase’s fast PostgreSQL infrastructure, not your WordPress
server. This often makes search faster than default WooCommerce.

#### Does it work with my theme?

Yes! The plugin uses standard WordPress and WooCommerce hooks. It includes live 
search support for Woodmart and standard WooCommerce product search forms, including
optional autocomplete dropdowns.

#### What does Search Autocomplete add?

When enabled, the frontend search dropdown can show matching products, suggested
search phrases, and product categories after just 2 characters. The markup is theme-
overridable by copying `templates/search-autocomplete.php` to `your-theme/aivesese/
search-autocomplete.php`.

#### Can I customize the search behavior?

Absolutely! The plugin is built with developer hooks and filters. Need custom field
indexing or search logic? Check our Premium setup service for advanced customization.

#### What happens to my data if I uninstall?

Your product data remains in your Supabase project – you have full control. The 
WordPress plugin only removes its settings and stops syncing. You can delete data
from Supabase manually if desired.

#### Is it GDPR compliant?

The plugin only syncs product data (names, descriptions, prices, etc.) – no personal
customer information. When semantic search is enabled, product text is processed
by OpenAI according to their privacy policy.

#### Can I use this on multiple stores?

Yes! Each store gets its own unique Store ID, allowing multiple WooCommerce sites
to use the same Supabase project while keeping data separate.

#### How do I display cart recommendations?

You can show AI-powered recommendations based on cart contents using:
 * **Shortcode:**`[
aivs_cart_recommendations]` – Add anywhere in your content * **Gutenberg Block:**
Search for “Cart Recommendations” in the block editor * **Elementor Widget:** Available
in Elementor’s widget panel * **Template Function:** `<?php echo do_shortcode('[
aivs_cart_recommendations]'); ?>` for theme files

### ⚡ Technical Requirements

 * **WordPress:** 6.0 or higher
 * **PHP:** 8.0 or higher (8.1+ recommended)
 * **WooCommerce:** 5.0 or higher
 * **Supabase Account:** Free tier sufficient for most stores
 * **OpenAI API Key:** Optional, only for semantic search

### 🔐 Privacy & Data Usage

### What Data is Synced?

 * Product names, descriptions, and short descriptions
 * SKUs, GTINs (EAN/UPC/ISBN), and brand information
 * Categories, tags, and custom attributes
 * Prices (regular, sale, cost) and stock status
 * Product images (URLs only) and ratings

### What Data is NOT Synced?

 * Customer information
 * Order details
 * Personal data
 * Payment information

### Third-Party Services

 * **Supabase:** Product data stored in your own Supabase project
 * **OpenAI:** Product text processed for embeddings when semantic search is enabled

All communication uses HTTPS. You maintain full control over your API keys and can
revoke access at any time.

### 🛠️ Support & Professional Services

### Community Support

 * Plugin documentation and FAQ
 * WordPress.org support forums
 * GitHub issues (for technical bugs)

### Premium Setup Service by ZZZ Solutions

 * **Complete Setup:** We install and configure everything for you
 * **Custom Field Mapping:** Index specific product attributes and meta fields
 * **Advanced Search Tuning:** Optimize search relevance for your catalog
 * **Multi-language Support:** Configure search for international stores
 * **Custom Recommendations:** Tailored recommendation algorithms
 * **Performance Optimization:** Fine-tune for large catalogs

[Contact ZZZ Solutions](https://zzzsolutions.ro) for professional setup and customization.

### 📝 Changelog

#### 1.0.2 (Latest)

 * **New:** Frontend search autocomplete for standard WooCommerce search forms and
   Woodmart live search, with product suggestions, matching search terms, category
   links, and template overrides
 * **New:** Partial-query fallback improves results for incomplete multi-word searches
   by combining token-level full-text, fuzzy, and SKU matching
 * **New:** Sync Products page now supports field-only batch sync for Cost of Goods,
   regular price, sale price, stock quantity, and stock status
 * **Update:** Cost sync now detects WooCommerce native COGS plus additional common
   cost-price meta keys, with variation-aware averaging for variable products
 * **Update:** Managed API pricing in the admin UI now shows the 19 EUR/month discounted
   plan through June 1
 * **Update:** Supabase margin is now stored as a percentage with null guards, with
   upgrade SQL included for existing databases
 * **Compatibility:** Search requests now start at 2 characters for faster autocomplete
   and partial-match discovery

#### 1.0.1

 * **New:** Browser-driven full catalog sync now runs in AJAX batches with live 
   progress feedback to avoid admin timeouts on large stores
 * **New:** Sync Products page now supports Managed API mode with mode-aware headings,
   validation, and synced-count reporting
 * **Update:** Sync overview now counts only searchable WooCommerce products and
   uses a shared connection manager for destination status
 * **Update:** Product sync truncates oversized name, description, short description,
   and SKU fields before API sync to prevent payload errors
 * **Compatibility:** Tested up to WordPress 6.9.1 and WooCommerce 10.5.3

#### 1.0.0

 * **Milestone:** Official stable release with production-ready feature set
 * **New:** Three flexible connection modes – Lite (local), Self-Hosted (Supabase),
   and Managed API Service
 * **New:** Complete WP-CLI command suite for professional database management and
   setup
 * **New:** Cart recommendations with shortcode, Gutenberg block, and Elementor 
   widget support
 * **New:** Search Analytics dashboard with detailed insights, CTR tracking, and
   zero-result alerts
 * **New:** Advanced encryption system with master key support for secure credential
   storage
 * **New:** Lite Mode TF-IDF engine with synonym expansion and stopword filtering
   for zero-dependency search
 * **Security:** Enhanced nonce verification and URL escaping throughout admin interface
 * **Security:** Encrypted PostgreSQL connection string storage with enterprise-
   grade protection
 * **Performance:** Optimized admin interface with modular asset loading and template
   system
 * **Performance:** Improved Supabase schema with re-runnable migrations and simplified
   RLS policies
 * **Compatibility:** PHP 8.0+ required, tested up to WordPress 6.9 and WooCommerce
   10.4.2
 * **Developer:** Better code organization following PSR-12 standards and WordPress
   best practices
 * **Developer:** Comprehensive hooks and filters for customization and extensibility

#### 0.18.3

 * **New:** Cart recommendations shortcode, block, and Elementor widget for flexible
   placement
 * **New:** Admin tool to update product sold_count in Supabase for …

## Screenshots

 * [[
 * [[
 * [[
 * [[
 * [[
 * [[
 * [[

## Blocks

This plugin provides 1 block.

 *   AI Cart Recommendations

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“AI Vector Search (Semantic)” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ eastercow ](https://profiles.wordpress.org/calingrim/)

[Translate “AI Vector Search (Semantic)” into your language.](https://translate.wordpress.org/projects/wp-plugins/ai-vector-search-semantic)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/ai-vector-search-semantic/),
check out the [SVN repository](https://plugins.svn.wordpress.org/ai-vector-search-semantic/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ai-vector-search-semantic/)
by [RSS](https://plugins.trac.wordpress.org/log/ai-vector-search-semantic/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **1.0.2**
 *  Last updated **3 weeks ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 8.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/ai-vector-search-semantic/)
 * Tags
 * [AI](https://kin.wordpress.org/plugins/tags/ai/)[recommendations](https://kin.wordpress.org/plugins/tags/recommendations/)
   [search](https://kin.wordpress.org/plugins/tags/search/)[semantic](https://kin.wordpress.org/plugins/tags/semantic/)
   [woocommerce](https://kin.wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://kin.wordpress.org/plugins/ai-vector-search-semantic/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/ai-vector-search-semantic/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ai-vector-search-semantic/reviews/)

## Contributors

 *   [ eastercow ](https://profiles.wordpress.org/calingrim/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ai-vector-search-semantic/)