Queryn - AI-powered Product Search for WooCommerce

Queryn transforms the way customers search your WooCommerce store. Instead of typing exact product names or SKUs, shoppers can describe exactly what they want in plain language — and Queryn's AI engine translates that into precise results in real time. Powered by the world's leading AI providers (OpenAI, Google Gemini, and Anthropic Claude), Queryn intelligently parses natural-language queries into structured WooCommerce filters: categories, tags, product attributes, price ranges, and custom meta fields — all without touching a single line of template code. Video Overview [youtube http://www.youtube.com/watch?v=I_QwIRryxpI]

"Show me red running shoes under $80" → Queryn automatically filters by color attribute, category, and max price. "Organic coffee beans above $20" → Queryn finds the right category and sets a minimum price filter. "Hello World" → Queryn finds your blog post titled Hello World alongside any matching products — normal search is never broken.

Search Scope — Products, Posts, and Pages Together Queryn is smart about when to restrict results to products and when to search broadly:

• Filter-based queries (price, category, tags, attributes) always search WooCommerce products only, because those filters are product-specific.
• Keyword-only queries search across all post types you configure — products, blog posts, pages, and any custom post types — so shoppers never hit a dead end just because no product matches.

You control exactly which post types are included in keyword searches from the Search Scope section on the General settings tab. WooCommerce products are always included and cannot be deselected. Apply AI Search On — Control API Costs The new Apply AI Search On setting lets you restrict when the AI engine is triggered:

• All search pages (default) — AI processes every search query site-wide.
• WooCommerce pages only — AI is triggered exclusively when a search is submitted from a WooCommerce page (shop, product categories, product tags). Searches from blog pages, contact pages, or any non-WooCommerce context skip the AI call entirely and fall back to standard WordPress search — saving API credits for queries that actually matter.

Your existing WordPress search behaviour is fully preserved. Queryn only modifies the main search query when a valid AI provider is configured and active. If the API key is missing, the plugin is inactive, or the AI call fails, WordPress falls back to its standard search without any interference. Why Queryn?

• Higher Conversion Rates — Shoppers who find products faster buy more. Natural language search removes friction from the discovery process.
• Zero Configuration Required — Queryn reads your existing WooCommerce categories, tags, and attributes automatically. No mapping, no manual setup.
• No Broken Search — Keyword searches that don't match any product will still surface blog posts, pages, and other content — shoppers are never shown an empty results page unnecessarily.
• Provider Flexibility — Switch between OpenAI, Google Gemini, and Anthropic Claude without losing your other API keys. Pre-configure all three and swap with one click.
• Smart Caching — AI responses are cached for one hour, dramatically reducing API usage and keeping your store fast.
• Privacy First — Only store taxonomy data (category names, tag names, attribute values) is sent to the AI. No customer PII, no order data.

Supported AI Providers OpenAI The industry standard for conversational AI. Queryn supports GPT-4o, GPT-4o Mini, and GPT-4 Turbo — choose the model that best fits your budget and accuracy needs. Google Gemini Google's multimodal AI family. Queryn supports Gemini 2.5 Pro, Gemini 2.5 Flash, and Gemini 2.5 Flash Lite. Gemini 2.5 Flash offers the best balance of speed, accuracy, and cost for most stores. Anthropic Claude Anthropic's safety-focused models deliver outstanding instruction-following and structured output. Queryn supports Claude Sonnet 4.6, Claude Haiku 4.5, and Claude Opus 4.7. What Gets Filtered Queryn extracts the following from a shopper's search query and applies them directly to WP_Query:

• Product Categories — mapped from your store's product_cat taxonomy
• Product Tags — mapped from your store's product_tag taxonomy
• Product Attributes — all pa_* attribute taxonomies (color, size, material, etc.)
• Price Range — minimum price, maximum price, a range, or an exact price ("priced at $15")
• Custom Meta Fields — any public meta key registered on your products
• Keyword — the core product term extracted for text-based title matching (intent words like "show me" or "find" are automatically ignored)

Privacy & Third-Party Services Queryn connects to the AI provider you configure. By enabling a provider, you agree to their terms of service and privacy policy:

• OpenAI: openai.com/policies/privacy-policy
• Google Gemini: policies.google.com/privacy
• Anthropic: anthropic.com/privacy

Data sent to the provider consists solely of your store's taxonomy structure (category names, tag names, attribute values, and public meta keys) and the shopper's search query. No personal customer data, email addresses, or order information is ever transmitted.

Automatic Installation (Recommended)

1. In your WordPress dashboard, navigate to Plugins → Add New.
2. Search for Queryn.
3. Click Install Now, then Activate.
4. Go to Settings → Queryn and configure your preferred AI provider.

Manual Installation

1. Download the plugin ZIP from the WordPress plugin directory.
2. In your dashboard, go to Plugins → Add New → Upload Plugin.
3. Upload the ZIP and click Install Now, then Activate.
4. Go to Settings → Queryn and enter your API key.

After Activation

1. Navigate to Settings → Queryn.
2. On the General tab, select your preferred AI provider.
3. On the General tab, review the Search Scope section and check the post types you want included in keyword searches.
4. Open the corresponding provider tab (OpenAI, Gemini, or Anthropic).
5. Paste your API key and choose a model.
6. Click Save Settings.
7. Test by searching your store with a natural language query such as "blue denim jacket under $100".

WooCommerce must be installed and active. Queryn will display an admin notice and remain inactive if WooCommerce is not detected.

1.0.0 & 1.0.1

• Initial public release.
• Natural language WooCommerce product search powered by AI.
• Support for OpenAI (GPT-4o, GPT-4o Mini, GPT-4 Turbo).
• Support for Google Gemini (2.0 Flash, 1.5 Pro, 1.5 Flash).
• Support for Anthropic Claude (3.5 Sonnet, 3.5 Haiku, 3 Opus).
• Filters: product category, tags, attributes, price range, custom meta fields.
• One-hour transient caching for AI responses.
• Modern tabbed settings dashboard under Settings → Queryn.
• PSR-4 SPL autoloader with Queryn\ namespace.
• WooCommerce HPOS (High-Performance Order Storage) compatibility declared.
• WooCommerce Cart & Checkout Blocks compatibility declared.
• Search Scope setting on the General tab — choose which post types (posts, pages, products, custom types) are included in keyword-only searches.
• Keyword-only searches now find blog posts, pages, and other content alongside products, so shoppers are never shown an empty results page just because no product matches.
• Product-filter searches (price, category, tags, attributes) continue to return WooCommerce products only — unchanged behaviour.
• Apply AI Search On setting — restrict AI processing to WooCommerce pages only to avoid unnecessary API charges on blog or page searches.
• Updated Google Gemini model list to the current 2.5 family: Gemini 2.5 Pro, Gemini 2.5 Flash (new default), and Gemini 2.5 Flash Lite.
• Updated Anthropic Claude model list to the current 4.x family: Claude Sonnet 4.6, Claude Haiku 4.5 (new default), and Claude Opus 4.7.