Queryn – AI-powered Product Search for WooCommerce

Description

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

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

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.

Screenshots

Installation

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.

FAQ

Will Queryn break my normal WordPress search for blog posts or pages?

No. Queryn is designed to work alongside standard WordPress search without disrupting it. For keyword-only searches, results are returned across all post types you select in the Search Scope settings (posts, pages, and products by default). Only when a query contains product-specific filters (price, category, attributes, etc.) does Queryn restrict results to WooCommerce products. If no AI provider is configured or a call fails, WordPress falls back to its default search behaviour automatically.

My shopper searched for a blog post title and got no results — why?

This was a known issue in version 1.0.0, fixed in 1.1.0. Earlier versions always restricted search results to WooCommerce products. After updating, keyword-only searches will include posts, pages, and any other post types you enable in Settings Queryn General Search Scope.

Do I need an API key?

Yes. You need an active API key from at least one of the supported AI providers — OpenAI, Google AI Studio (for Gemini), or Anthropic. All three offer free tiers or trial credits to get started.

Will this slow down my store?

Queryn only makes an API call on search pages, and only when a shopper performs a search. Responses are cached for one hour per unique query using WordPress transients, so repeated searches hit your database rather than the AI API.

Which AI provider should I choose?

  • Lowest cost: Gemini 2.5 Flash Lite or GPT-4o Mini.
  • Highest accuracy: GPT-4o, Gemini 2.5 Pro, or Claude Opus 4.7.
  • Best balance: Gemini 2.5 Flash or Claude Haiku 4.5.

You can configure all three providers simultaneously and switch between them without losing any API keys.

Does it work with all WooCommerce themes?

Yes. Queryn hooks into pre_get_posts and modifies WP_Query before any theme renders the results. It is fully compatible with all standard WooCommerce-aware themes including Storefront, Astra, GeneratePress, Flatsome, and block-based themes.

What data is sent to the AI provider?

Only your store’s taxonomy structure (category names, tag names, attribute names and values, and public custom field keys) alongside the shopper’s search query. No customer accounts, email addresses, order data, or personally identifiable information is ever sent.

Can I use multiple AI providers at the same time?

Only one provider handles search queries at a time. However, you can pre-configure API keys for all three providers and switch the active one instantly from Settings Queryn General.

Can I prevent the AI from firing on every single search to save API costs?

Yes. In Settings Queryn General Apply AI Search On, switch from “All search pages” to “WooCommerce pages only”. When this option is active, the AI is only called when a search originates from a WooCommerce page (shop, product category, product tag). Searches from blog pages, static pages, or other non-WooCommerce areas skip the AI entirely and use standard WordPress search — so you are only charged for queries that are actually product-relevant.

Can I choose which post types appear in search results?

Yes. In Settings Queryn General, the Search Scope section lists all public post types registered on your site. Check the ones you want included in keyword-only searches. WooCommerce products are always included. Filter-based searches (price, category, etc.) always return products only, regardless of this setting.

Searching for an exact price like “products priced at $15” returns no results — is that a bug?

This was a bug in 1.0.0, fixed in 1.1.0. The AI now correctly maps “price is X” / “costs X” / “priced at X” to an exact price filter, and the underlying query uses a direct equality comparison rather than a range. Update to 1.1.0 and the search will work correctly.

Is Queryn compatible with WPML or multilingual stores?

Queryn reads taxonomy names in whatever language they are stored in your database. If you use WPML or Polylang and your category/tag names are translated, the AI will receive the translated names for the current language context.

Where can I get an API key?

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Queryn – AI-powered Product Search for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

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.