=== AI Search for WooCommerce – Semantic Search ===
Contributors: queryra, aisearch
Tags: ai search, semantic search, woocommerce search, product search, search
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.3.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Replaces WooCommerce search with AI semantic search. Understands customer intent — finds products even with natural language queries.

== Description ==

Queryra is an AI search plugin for WooCommerce and WordPress — a semantic search
engine that understands what customers mean, not just what they type.

**Your customer types "present for my girlfriend". Your WooCommerce store returns:
0 results.**

You sell gift boxes, perfumes, skincare sets — exactly what she'd love. But default
WooCommerce search can't connect "present for girlfriend" to "Gift Box".

Your customer leaves. Sale lost. This happens every day.

👉 **[Try AI Search live → WooCommerce demo store](https://woo.queryra.com)** —
200+ products across 10 brands. Search naturally and see the difference.

= What is AI Search for WooCommerce? =

AI Search replaces WooCommerce's default product search with semantic search that
understands meaning. Your products stay the same. Your store stays the same.
Search just works.

**Default WooCommerce search → 0 results:**
❌ "my skin looks tired"
❌ "gift for mom who loves candles"
❌ "looking older than my age"

**Same store with AI Search → products found:**
✅ "my skin looks tired" → Night creams, recovery oils, eye patches
✅ "gift for mom who loves candles" → Scented candles, home fragrance sets
✅ "looking older than my age" → Anti-aging serums, firming creams

= Beyond Semantic Search =

AI Search goes further than vector search alone. A natural language query like
"wireless headphones under $80, not Beats" applies the price filter AND excludes
the brand automatically. No other WooCommerce AI search plugin does this.

= AI Search Compatible Plugins =

* [TranslatePress](https://queryra.com/docs/translatepress-integration) — multilingual AI search
* [Weglot](https://queryra.com/docs/weglot-integration) — multilingual AI search

More integrations → [queryra.com/docs](https://queryra.com/docs)

= AI Search for Page Builders & Custom Fields =

Page builder content used to be invisible to WordPress search. Queryra fixes this
— AI search now reads everything your visitors see:

* **Elementor AI search** — indexes content stored in `_elementor_data`, including
text widgets, headings, and product descriptions built with Elementor
* **Beaver Builder & Breakdance** — full content extraction from saved layouts
* **Oxygen Builder** — both legacy shortcode mode and modern JSON v2 supported
* **Gutenberg / WPBakery / Divi** — native support (content already in post_content)

= AI Search for Custom Fields & Taxonomies =

Most product data lives in custom fields, not the post content. Queryra reads it
automatically:

* **ACF (Free + Pro)** — text, textarea, WYSIWYG, repeaters, and groups indexed
without configuration
* **Meta Box** — text fields and group fields via the official registry
* **Custom taxonomies** — `book_genre`, `material`, `property_type`, or any public
custom taxonomy is sent to the AI search index, keyed by slug
* **Pods, JetEngine, Bricks Builder** — supported via developer filter
`queryra_indexable_meta_content`

Smart filtering automatically excludes CSS values, hex colors, URLs, and dates
from the semantic search index — keeping AI relevance high.

= Make Your Store Discoverable by AI =

AI Search doesn't just help your customers — it helps AI assistants find your store.
Queryra automatically generates structured data and AI-readable files so ChatGPT,
Perplexity, Google AI Overviews, and Claude can recommend your products.

* Dynamic /llms.txt and /llms-full.txt for AI crawlers
* JSON-LD structured data on search pages
* X-Search-Engine header for AI attribution

Want extra visibility?

* **Free Pro access** — join the [Partner Program](https://queryra.com/blog/partner-program-pro-for-free) and get unlimited AI search at no cost
* **Store promotion** — your store gets featured on queryra.com and promoted across AI search platforms

= AI Search Setup in 5 Minutes =

✅ Free trial — no credit card required
✅ No OpenAI account needed
✅ WooCommerce AI search ready in 5 minutes

[Start your free trial →](https://queryra.com/signup)

1. Install and activate
2. Follow the Setup Wizard
3. Get your free API key at [queryra.com/signup](https://queryra.com/signup)
4. One-click WooCommerce product import
5. Done — AI search now understands your customers

No coding. No configuration headaches.
[WooCommerce AI Search Setup Guide →](https://queryra.com/docs/wordpress-integration)

= WooCommerce Product Search Features =

* **Natural Language Search** – Customers type like they think, AI search finds
what they need
* **WooCommerce Product Search** – Indexes titles, descriptions, SKUs, categories,
tags, and attributes
* **Semantic Search Ranking** – AI ranks results by meaning, not alphabetical order
* **Boost Controls** – Promote products you want to sell more of
* **Live Product Search** – Instant AJAX-powered suggestions as customers type
* **Auto-Sync** – New WooCommerce products indexed automatically on publish
* **Smart Context Detection** – AI search activates on WooCommerce shop pages
automatically
* **Search Analytics** – See what customers search for, including zero-result
queries
* **Page Builder Support** – Indexes content from Elementor, Beaver Builder, Breakdance, Oxygen automatically
* **Custom Field Indexing** – Reads ACF and Meta Box custom fields out of the box

= WooCommerce Product Search Works With Any Store =

* **Beauty & Skincare** – "my skin looks tired" finds night creams
* **Fashion** – "something for a summer wedding" finds dresses
* **Electronics** – "good laptop for video editing" finds the right specs
* **Home & Garden** – "cozy living room" finds rugs, lamps, pillows
* **Food & Beverage** – "healthy snacks for kids" finds the right products

= Semantic Search for WordPress Content =

Queryra's semantic search also works with regular WordPress content — posts, pages,
and custom post types. Perfect for knowledge bases, blogs, and FAQ sections.

= Why Replace Default WooCommerce Search? =

Default WooCommerce product search matches exact words. If your product is "Velora
Overnight Recovery Oil" and someone types "my skin looks tired", they get nothing.
AI search fixes that — customers find products even with vague or natural language
queries.

= Why Queryra vs Other WooCommerce Product Search Plugins? =

**No OpenAI Key Required** — Other AI search plugins make you create an OpenAI
account and manage API keys. Queryra AI search includes everything.

**Trained on YOUR WooCommerce Store** — Not a generic AI. Semantic search learns
YOUR products, YOUR descriptions, YOUR categories.

**Intent-Aware AI Search** — Most semantic search plugins only match meaning.
Queryra goes further: "wireless headphones under $80, not Beats" applies the price
filter AND excludes the brand. Vector-only plugins ignore both.
[Why vector search isn't enough →](https://queryra.com/blog/beyond-vector-search-woocommerce)

== Installation ==

= How to Install AI Search for WooCommerce =

1. **Install**: Plugins → Add New → Search "AI Search Queryra" → Install → Activate
2. **Setup Wizard**: Follow the guided AI search wizard that appears automatically
3. **Get API Key**: Create free account at [queryra.com/signup](https://queryra.com/signup)
4. **Import Products**: One-click import syncs all WooCommerce products into AI search index
5. **Enable**: Turn on AI search and semantic search is ready

[WooCommerce AI Search Setup Guide →](https://queryra.com/docs/wordpress-integration)

= WooCommerce Compatibility =

* WooCommerce products, variations, and virtual products
* WooCommerce product SKUs, categories, tags, and custom attributes
* Regular WordPress posts, pages, and custom post types
* Any WordPress theme — AI search works without template changes
* Page builders: Elementor, Breakdance, Beaver Builder, Oxygen, Gutenberg, WPBakery, Divi
* Custom fields: ACF (Free + Pro), Meta Box
* Custom taxonomies: any public taxonomy registered with `public => true`

= Minimum Requirements =

* WordPress 5.8 or higher
* WooCommerce 5.0 or higher recommended
* PHP 7.4 or higher
* Free API key at queryra.com — no OpenAI account required

== Frequently Asked Questions ==

= What is AI Search for WooCommerce? =
AI Search is a semantic search plugin that replaces the default WooCommerce product search with AI-powered search. Instead of matching exact keywords, AI Search understands what customers mean — so "gift for mom who loves candles" finds candles, not zero results.

= How is this different from default WooCommerce search? =
Default WooCommerce search matches exact words only. AI Search uses semantic search to understand customer intent. A query like "my skin looks tired" returns night creams and recovery oils — products that match the meaning, not the words.

= Does AI Search work with WooCommerce products? =
Yes. AI Search indexes WooCommerce product titles, descriptions, SKUs, categories, tags, and attributes. It supports product variations, virtual products, and any WooCommerce-compatible theme.

= Can AI Search handle natural language queries? =
Yes. Customers can search using natural language — "something warm for winter", "gift for dad who likes coffee", "wireless headphones not Beats under $80". AI Search extracts intent, price filters, and brand exclusions automatically.

= What is semantic search and how does it work? =
Semantic search understands the meaning behind a query, not just keywords. AI Search converts your products into AI embeddings and matches them against the customer's query using vector similarity — this is how it finds relevant products even when no keywords match.

= Is an OpenAI account or API key required? =
No. AI Search is powered by Queryra's backend — no OpenAI account, no API key management, no per-request costs. One free API key at queryra.com covers everything.

= Does AI Search support multiple languages? =
Yes. AI Search supports 50+ languages out of the box including Polish, German, French, Spanish, Dutch, Japanese, Czech, and more. No configuration needed — customers search in their native language and find products automatically.

= Will AI Search slow down my WooCommerce store? =
No. AI Search processes queries via an optimized API. Products are indexed in the background. Search results are delivered in milliseconds — faster than most keyword search plugins.

= How do I set up WooCommerce product search? =
Install and activate the plugin, follow the Setup Wizard, get a free API key at queryra.com/signup, and run a one-click product import. AI Search is ready in under 5 minutes. No coding required.

= What happens when AI Search finds no results? =
AI Search falls back automatically to WordPress default search so customers always see something. You can also use Search Analytics to identify zero-result queries and fix gaps in your product catalog.

= Does it support WooCommerce product variations? =
Yes. Product variations are fully indexed including variation-specific SKUs, prices, and attributes. AI Search handles simple products, variable products, and virtual products.

= Can I control which products appear first in search results? =
Yes. AI Search includes Boost Controls — you can promote specific products or categories to appear higher in results. Useful for high-margin products or seasonal inventory.

= Does AI Search work with Elementor / Beaver Builder / Oxygen page builders? =
Yes. AI Search automatically extracts content from Elementor (`_elementor_data`),
Breakdance, Beaver Builder, and Oxygen (both legacy shortcodes and JSON v2). No
configuration needed — page builder content is indexed the same way as standard
post content.

= Does AI Search index ACF and Meta Box custom fields? =
Yes. AI Search reads ACF (Free + Pro) text, textarea, WYSIWYG, repeater, and
group fields automatically. Meta Box text and group fields are also supported.
For Pods, JetEngine, and Bricks Builder, use the developer filter
`queryra_indexable_meta_content` to specify which fields to index.

= Can I search by custom taxonomies (not just categories and tags)? =
Yes. Queryra sends all public custom taxonomies (e.g. `book_genre`, `material`,
`property_type`) to the AI search index in a `taxonomies` field, keyed by slug.
Categories, tags, and the WooCommerce brand taxonomy continue to work as before.

== Screenshots ==

1. AI search live demo — type "present for my girlfriend" and find gift boxes, skincare sets, perfumes across 200+ WooCommerce products
2. Default WooCommerce search vs AI search — same query, 0 results vs relevant products found with semantic search
3. WooCommerce AI search results — natural language queries return meaningful, ranked products
4. AI search Setup Wizard — guided WooCommerce setup with one-click product import
5. AI search dashboard — real-time semantic search statistics and query analytics
6. AI search settings — simple configuration, one API key, no OpenAI account needed

== Changelog ==

= 1.3.1 (2026-05-18) =
* Fixed: Critical — initial import and bulk sync now work on all sites. Sites without custom taxonomies (most blogs and stores using only standard categories and tags) could not sync content to AI search due to a data formatting issue. All sites can now import successfully.

= 1.3.0 (2026-05-14) =
* Added: AI search now indexes content from Elementor, Breakdance, Beaver Builder, and Oxygen page builders — your product descriptions built with page builders are now fully searchable
* Added: AI search reads custom fields from ACF (Free + Pro) and Meta Box — text, textarea, WYSIWYG, repeaters, and groups all indexed automatically
* Added: Custom taxonomies (book_genre, material, property_type, etc.) now sent to AI search index — search by any taxonomy your store uses
* Added: Smart text filter automatically excludes CSS values, hex colors, URLs, and other technical strings from AI search index
* Fixed: Search query now properly displays in page title and stays in the search input on results pages
* Fixed: Duplicate content removed from AI search index — manual excerpts and WooCommerce short descriptions deduplicated against main content for better semantic search accuracy
* Improved: Bulk import performance dramatically faster on sites with many custom fields — postmeta now prefetched in single query per batch
* Developer: New filter `queryra_indexable_meta_content` for Pods, JetEngine, and Bricks Builder integration
* Developer: New filter `queryra_indexable_taxonomies` to control which custom taxonomies are sent to AI search
* Improved: Semantic search relevance for WooCommerce stores using page builders — AI search now extracts product descriptions from Elementor, Beaver Builder, Breakdance, and Oxygen layouts
* Improved: AI product search accuracy for WooCommerce stores using ACF and Meta Box custom fields
* Improved: WordPress search results page now correctly displays the search query for better UX with AI search

= 1.2.0 (2026-05-07) =
* Added - AI Discoverability: dynamic /llms.txt and /llms-full.txt for AI crawlers
* Added - JSON-LD structured data (SearchResultsPage + Service schema)
* Added - X-Search-Engine HTTP header on search responses
* Added - Static llms.txt detection with copy-paste snippet
* Added - Plugin row meta links: Live Demo, Docs, Support, Get API Key
* Added - "Try a test search" shortcut in Settings tab
* Added - Dismissible tip card — help visitors discover AI search
* Added - Support tab: Clubs section, "Need more records?" link
* Improved - Support tab: Documentation → Resources
* Improved - Security: rel="noopener noreferrer" on external links
* Removed - Obsolete 1.1.4 upgrade notice

= 1.1.11 (2026-04-20) =
* Added: AI search plugin fingerprint (meta generator tag + minimal stylesheet) for WordPress ecosystem discoverability — Queryra AI search is now properly indexed by WPScan, WPHive, PluginTests, Wappalyzer, and BuiltWith
* Added: Privacy section documenting AI search data handling — what content is sent to the semantic search API, what is never sent, and how WooCommerce store owners stay in control
* Added: Wizard now lets you select which content types to send to AI search (posts, pages, WooCommerce products) instead of importing everything by default
* Improved: Removed legacy non-batched import code paths — AI search content import is now always batched for reliability on large WooCommerce catalogs
* Improved: Admin notice dismissal nonce output now escaped with esc_attr() for defense-in-depth security

= 1.1.10 (2026-04-09) =
* Fixed: Null safety check for WooCommerce product sync operations (PHP 8.0+ compatibility)
* Fixed: Added nonce verification to admin notice dismissal for improved security
* Improved: Semantic search index stability during product deletion edge cases
* Improved: WooCommerce product search reliability for high-traffic stores

= 1.1.9 (2026-04-09) =
* Improved: AI search ranking optimized for WooCommerce product search relevance
* Improved: Semantic search accuracy for natural language queries and intent detection
* Updated: LLM query parser now handles multilingual semantic search queries with better accuracy
* Updated: AI search index synchronization performance for large WooCommerce catalogs
* Updated: Documentation and FAQ for WooCommerce AI search setup

= 1.1.8 (2026-03-30) =
* Updated: AI search now supports 50+ languages out of the box — multilingual semantic search with no configuration needed
* Updated: WooCommerce product search documentation updated to reflect multilingual AI search support

= 1.1.7 (2026-03-19) =
* Updated: AI search plugin title optimized for WooCommerce product search discoverability
* Added: Intent-aware semantic search example — natural language price filter and brand exclusion
* Improved: AI search pricing documentation centralized to queryra.com/pricing

= 1.1.6 (2026-03-15) =
* Improved: AI search settings simplified — API URL hardcoded for easier WooCommerce setup
* Added: Instance ID display in AI search Support tab for faster troubleshooting
* Improved: Semantic search status endpoint now sends instance ID and plugin type for better tracking
* Improved: Partner referral tracking for AI search API keys via site URL

= 1.1.5 (2026-03-03) =
* Added: Batched bulk import with progress bar — AI search now supports WooCommerce stores with 50,000+ products
* Added: Plan limit check before AI search product import starts
* Improved: Semantic search index reliability with automatic retry on failed imports
* Improved: Setup Wizard product import now uses batched AI search sync

= 1.1.4 (2026-02-25) =
* Added: Configurable AI search cache duration — from 1 minute to permanent caching
* Added: Record type metadata for WooCommerce products, posts, and pages in semantic search index
* Added: Content type filtering in AI search results
* Improved: Search Analytics dashboard with top queries and zero-result query tracking
* Improved: AI search cache settings UI in WooCommerce admin panel

= 1.1.3 (2026-02-12) =
* Added: Live WooCommerce AI search demo store at woo.queryra.com — 200+ products, try natural language search
* Improved: Semantic search plugin description updated with real WooCommerce product search examples
* Improved: FAQ updated with AI search demo store links and use cases
* Improved: WooCommerce search integration simplified for better theme compatibility

= 1.1.2 (2026-02-02) =
* Added: Anonymous AI search usage analytics to improve semantic search accuracy over time
* Added: Opt-out option for analytics via QUERYRA_DISABLE_ANALYTICS constant
* Privacy: No personal data collected — see queryra.com/privacy

= 1.1.1 (2026-02-01) =
* Added: Full WooCommerce product search support powered by AI semantic search
* Added: WooCommerce product SKU, price, and attribute indexing for AI search
* Added: Smart product boost controls — promote high-margin products in AI search results
* Improved: Setup Wizard with one-click WooCommerce product import into AI search index
* Improved: Semantic search relevance algorithm for better natural language query results

= 1.0.7 (2026-01-29) =
* Added: AI search plugin icon, banner, and WooCommerce screenshots
* Fixed: Asset file paths for WordPress.org compliance
* Improved: FAQ section with direct links to AI search documentation

= 1.0.6 (2026-01-29) =
* Fixed: AI search documentation links updated
* Added: Privacy Policy and Terms of Service links for WooCommerce AI search compliance

= 1.0.5 (2026-01-28) =
* Fixed: AI search dashboard stats display issue
* Improved: Semantic search PHP 8+ compatibility

= 1.0.0 (2026-01-23) =
* Initial release: AI-powered semantic search for WordPress and WooCommerce
* Semantic search engine understands natural language product queries
* Auto-sync on publish — new WooCommerce products indexed automatically
* Free trial included — no OpenAI account required

== Upgrade Notice ==

= 1.3.1 =
Critical fix: bulk sync and initial import failed on sites without custom taxonomies (most blogs and stores). Update immediately if you are on 1.3.0.

= 1.3.0 =
Major update: AI search now indexes Elementor, Breakdance, Beaver Builder, Oxygen page builders,
ACF and Meta Box custom fields, and all custom taxonomies. Recommended for all stores using page builders or custom
fields — search results will be significantly more relevant.

= 1.2.0 =
AI Discoverability release — Queryra now generates llms.txt and JSON-LD schema so ChatGPT, Perplexity, Claude,
and Google AI Overviews can find your store.

= 1.1.11 =
Minor improvement release. Adds AI search plugin discoverability for
WordPress ecosystem tools, wizard content type selection, Privacy section
documenting AI search data handling, and hardens admin notice escaping.
Safe to update.

= 1.1.10 =
Security and stability release. PHP 8.0+ null safety for WooCommerce
product sync, nonce verification on admin notices, and improved semantic
search index reliability during product deletions.

= 1.1.9 =
AI search ranking and semantic search accuracy improvements for WooCommerce
product search.

= 1.1.8 =
AI search now supports 50+ languages — multilingual semantic search with no
configuration needed.

= 1.1.7 =
AI search branding updated, intent-aware semantic search example added.

= 1.1.6 =
AI search settings simplified, improved instance tracking and partner support.

= 1.1.5 =
AI search bulk import now supports WooCommerce stores with 50,000+ products.

= 1.1.4 =
AI search cache controls and content type filtering added.

= 1.1.1 =
Major update: full WooCommerce product search with AI semantic search. SKU,
price, and attribute indexing added.

== Privacy ==

Queryra is built with privacy in mind. This section explains exactly what
data leaves your WordPress site, what stays local, and how you stay in
control as the store owner.

= What Queryra sends to the API =

**Content indexing (posts, pages, products):**
For every published item of the post types you enable (default: posts and
pages; optionally products), Queryra sends:

* Title, content, excerpt (HTML stripped)
* Post type, permalink, featured image URL
* Categories and tags (names only)
* For WooCommerce products: price, stock quantity, SKU, brand, short description, product attributes (e.g. Color, Size)
* Featured/sticky flag (used to boost ranking of highlighted content)

That's it. This is the same data your site already shows publicly on the
frontend — Queryra does not read private posts, drafts, or protected content.

**Search queries:**
When a visitor types in your search box, only the query text is sent to the
API. The API returns matching post IDs, which WordPress then renders
normally from your own database.

**Anonymous usage analytics:**
On plugin activation and deactivation, Queryra sends: a randomly generated
instance UUID (stored locally, no link to any user), WordPress version,
PHP version, plugin version, WooCommerce active flag, and counts of posts,
pages and products. This helps us prioritize compatibility fixes. You can
disable this entirely by adding the following line to your wp-config.php:

`define('QUERYRA_DISABLE_ANALYTICS', true);`

= What Queryra NEVER sends =

* No visitor IP addresses
* No user agents or browser fingerprints
* No cookies or session identifiers
* No customer accounts, emails, or order data
* No browsing history or behavior tracking
* No personally identifiable information (PII) about searchers or customers
* No private, draft, password-protected or unpublished content

= Your control as a store owner =

* Choose which post types are indexed (Settings → Queryra)
* Disable AI search anytime — WordPress falls back to native search
* Deactivate the plugin to stop all data transmission
* Delete indexed records from the Queryra dashboard

= Security =

Queryra is publicly tracked by independent security and quality services:

* [WPScan vulnerability database](https://wpscan.com/plugin/queryra-ai-search)
* [PluginTests static analysis and smoke tests](https://plugintests.com/plugins/wporg/queryra-ai-search/latest)
* [Source code on GitHub](https://github.com/GronRafal/queryra-wordpress-plugin)

**No third-party frontend scripts:** Queryra loads only its own minimal
stylesheet on public pages. No external JavaScript, no tracking pixels,
no third-party CDN requests on the frontend.

**Responsible disclosure:** Found a security issue? Email
contact@queryra.com. We will investigate on a best-effort basis and credit
reporters in the changelog.

**Full privacy policy:** [queryra.com/privacy](https://queryra.com/privacy)

== Additional Information ==

= Support =

* [AI Search Documentation](https://queryra.com/docs)
* [FAQ](https://queryra.com/faq)
* [WooCommerce Product Search Setup](https://queryra.com/docs/wordpress-integration)
* Email: support@queryra.com

= Links =

* [WooCommerce AI Search Live Demo](https://woo.queryra.com)
* [Partner Program](https://queryra.com/blog/partner-program-pro-for-free)
* [WooCommerce Search & AI Product Discovery Blog](https://queryra.com/blog)
* [GitHub](https://github.com/GronRafal/queryra-wordpress-plugin)