SearchX for WooCommerce

By commercex

0+ active installationsVersion 2.7.0

AI-powered live search for WooCommerce: instant results as you type, typo tolerance, Greeklish, smart filters and search analytics.

Description

SearchX replaces the default WooCommerce search with AI-powered instant search: results appear as the customer types, with typo tolerance, synonyms, smart ranking and rich filters — so shoppers find the right product in seconds. Built both for store owners and for agencies and freelancers who build WooCommerce shops for their clients.

▶ Live demo — a WooCommerce store running SearchX: type “ipone” and watch typo tolerance find the right products.

Website · Documentation · Start a free trial

Search experience

  • Instant search-as-you-type — real-time results with product images and prices, plus recent & top searches and featured products in the popup (show anywhere from 5 to 50 results)
  • Add to cart & wishlist directly from the results — native WooCommerce add-to-cart; YITH WooCommerce Wishlist supported
  • Full results page with faceted filters: category, brand, price range, on-sale, size, color — and search inside the filters
  • Custom filters from your own feed — extra attributes in your XML feed (material, RAM, screen size…) become filters, with your own labels per language
  • One result per product — optionally group size and colour variants so each product page appears once
  • Typo tolerance (adjustable) — “snaeker” still finds “sneaker”
  • Greeklish support (“papoutsia” finds “παπούτσια”) and wrong-keyboard-layout detection, product codes included
  • Voice search — shoppers speak instead of typing (supported browsers)
  • AI semantic matching (beta) — optional layer matching shopper intent beyond exact keywords
  • Ask AI (beta) — optional conversational product search (“sofa for a small balcony”)
  • URL filters & deep linking — results and filters become shareable, bookmarkable URLs
  • Mobile-first — responsive modal, slide-up filters, touch optimized

Merchandising, analytics & catalog

  • Product pinning & showcase (bestsellers, seasonal) and suggested links
  • Synonym groups with visual editor + CSV import, stop words, searchable-attribute priorities
  • Real-time analytics dashboard: searches, CTR, zero-result queries, top terms & products, conversion funnel, device & location breakdown, session journeys
  • Sales from search — paid orders and revenue that came from search, next to your store’s total. Turn on Send orders to SearchX in the plugin settings — no code to paste
  • Catalog sync via XML feed (Google Merchant Center, Facebook, Skroutz formats) — automatic re-import hourly or daily, zero-downtime reindexing, detailed import reports
  • Plans by catalog size — up to 20,000, 50,000 or 100,000 products, and Enterprise above that
  • 50+ languages with RTL support and custom translations — English & Greek included

Built for WordPress & WooCommerce

  • [searchx_bar] and [searchx_page] shortcodes — place them in any page, template, widget or menu area
  • Settings under WooCommerce → Settings → SearchX (or via SEARCHX_* constants in wp-config.php)
  • Direct mode (recommended): searches go straight from the browser to SearchX with a restricted public browser key — search-only, locked to your website’s origin, and no search traffic on your WordPress server
  • Proxy mode (the plugin’s default setting): searches pass through your site, your private API key stays server-side and each shopper keeps their own rate limit
  • Performance caching: keep a local copy of the SDK (verified against the CDN’s SHA-256 manifest, with CDN fallback) and cache the search settings with a maximum age, background refresh and one-click clearing. Authentication, search results and CSS are never cached by the plugin
  • Load SearchX on every page (default, for header and template placements) or only where a SearchX shortcode renders
  • Uses the React bundled with WordPress core when available
  • Cookie consent: optionally wait for the shopper’s consent before setting SearchX cookies — automatic with the WP Consent API, or one line of JavaScript from any cookie banner
  • HPOS and Cart/Checkout blocks compatible; the plugin reads orders only when you turn on Send orders to SearchX
  • Inert until configured: nothing loads on your storefront until you save your credentials
  • Setup in about 5 minutes — no core or theme files are modified, clean install and clean uninstall (removes all its options)

How it works & pricing

This plugin is a connector for the SearchX service. All catalog and search management happens in the SearchX admin (admin.searchxengine.ai):

  1. Sign up and create your application in the SearchX admin.
  2. Connect your product XML feed — Google Merchant Center, Facebook or Skroutz format. This is how your products get into SearchX: the plugin does not read or sync your WooCommerce product database. SearchX imports the feed and re-syncs it automatically on a schedule (hourly or daily).
  3. Paste your App ID, API Key and public browser key into the plugin settings and add the shortcodes. Searches are served from the SearchX cloud, so your server stays fast even with large catalogs.

A SearchX account is required — 14-day free trial, no credit card required. Plans are priced by catalog size, with unlimited searches on every plan and no hidden fees:

  • Core — up to 20,000 products: €49/month or €490/year
  • Growth — up to 50,000 products: €99/month or €990/year
  • Scale — up to 100,000 products: €199/month or €1,990/year
  • Enterprise — above 100,000 products: custom quote

Optional SEO & AI Visibility add-on — €19.90/month: helps more shoppers find your products on Google and in AI assistants, and includes a monthly deep SEO scan. Details on the pricing page.

Synonyms, merchandising, custom filters, top searches, suggested links, custom widget CSS, custom translations and analytics are managed in the SearchX admin — the plugin’s settings tab controls credentials, request mode, orders, cookie consent, caching and widget behaviour/appearance.

The optional AI features (AI semantic matching, Ask AI) are in beta. SearchX adds no extra charge for them, but they require your own OpenAI API key — OpenAI usage is billed to you by OpenAI. Standard search works fully without them.

Add to cart & wishlist

  • Add to cart uses WooCommerce’s native flow: clicking add-to-cart in the results navigates to ?add-to-cart=PRODUCT_ID&quantity=1. For this to work, the product IDs in your XML feed (unique_id) must be your WooCommerce product IDs.
  • Wishlist: when YITH WooCommerce Wishlist is active, wishlist clicks are handled automatically through YITH’s API (via a nonce-protected REST endpoint). Without YITH, the plugin fires the SearchX:woocommerceAddToWishlist browser event so your theme can implement custom handling — no fatal errors either way.

Beyond WooCommerce

SearchX also integrates with OpenCart (official marketplace extension), Shopify and custom storefronts — one search platform for every shop you run or build.

For agencies & developers

Building shops for clients? The SearchX Referral Partner program pays a 20% recurring commission on every referred subscription, free to join — learn more.

External services

This plugin connects to the SearchX service. It is inert until you enter your SearchX credentials; after that:

  • SearchX API (admin.searchxengine.ai): receives search queries, an anonymous session identifier and analytics events (queries, product clicks, page views, add-to-cart events) so search results and the analytics dashboard work. In the recommended direct mode the shopper’s browser calls the API itself with your public browser key; in proxy mode (the plugin’s default setting) these requests go through a server-side proxy on your site. No customer names, emails or account data are read from your store. Provider: SearchX — Terms of Service, Privacy/DPA.
  • SearchX CDN (sdk.searchxengine.ai): provides the SDK JavaScript bundle that renders the search UI, and its SHA-256 artifact manifest. When SDK caching is enabled (the default), the plugin verifies the downloaded bundle against that manifest before serving a copy from its own cache directory, and checks the CDN periodically for updates; the CDN remains the fallback.
  • OpenAI (optional, beta AI features only): if you enable AI features with your own OpenAI API key, the queries used by those features are processed by OpenAI under your agreement with OpenAI.

  • Orders (optional, off by default): when you turn on Send orders to SearchX, your server sends each paid order to the SearchX API with your private API key, and again if it is cancelled or refunded: order number, status, currency, total, order date, line items (product ID, SKU, name, quantity, price) and the anonymous session identifier. No customer names, emails, addresses or phone numbers.

The widget sets two first-party cookies on your store’s domain: _sx_sid_<app id> (the anonymous search session, 30 minutes, renewed with activity) and _sx_last_sid_<app id> (the last session with search activity, kept for 7 days so orders can be attributed to search). It also keeps the shopper’s last five searches, cached widget translations and the address of your custom widget CSS in localStorage. Search works without the cookies: turn on Wait for the shopper’s consent and no SearchX cookie is set until the shopper allows statistics cookies (through the WP Consent API, or your banner calling window.searchxSetCookieConsent(true)); until then the session stays in memory. The plugin itself does not cache credentials or authentication responses. Depending on your jurisdiction and consent tooling you may need to disclose these in your privacy/cookie policy.

Installation

Requirements: WordPress 6.5+, WooCommerce 8.0+ (installed and active), PHP 7.4+, a SearchX account.

1. Create your SearchX application and connect your feed

Sign up at admin.searchxengine.ai and create your application. Connect your product XML feed (Google Merchant Center, Facebook or Skroutz format) and choose the import schedule (hourly or daily) — this is how your products get into SearchX; the plugin does not read your WooCommerce database. Make sure the feed’s product IDs are your WooCommerce product IDs so add-to-cart works. Then copy the App ID and API Key from the application page.

For the recommended direct mode, also create a public browser key: on the application’s API Keys tab click New key, choose the Public browser search scope and confirm with the code SearchX emails you. Public browser keys only work from the website address set on your application (see screenshot 14).

2. Install and activate the plugin

Go to Plugins → Add New, search for searchx, install SearchX for WooCommerce and activate it. The plugin is inert until credentials are configured — before setup it loads nothing on your storefront.

3. Connect your credentials

Go to WooCommerce → Settings → SearchX, paste your App ID and API Key, and click Save changes. Under Search requests, choose Direct to SearchX and paste your public browser key — the setup we recommend. Through WordPress is the plugin’s current default and keeps all search traffic behind a proxy on your site. The plugin refuses Direct to SearchX until a public browser key is saved, so your storefront is never left without search. Keep the default API URL unless SearchX support tells you to change it. Custom widget CSS and translations are configured per application in the SearchX admin (SDK settings) and are applied automatically.

Caching is on by default: settings you change in the SearchX admin reach your store within a few minutes, or straight away if you click Clear SearchX cache.

Optional, in the same tab under Sales from search & cookies: turn on Send orders to SearchX to feed the Sales from search card, and Wait for the shopper’s consent if your store asks shoppers for cookie consent.

Prefer keeping credentials out of the database? Define SEARCHX_APP_ID, SEARCHX_API_KEY and SEARCHX_PUBLIC_KEY in wp-config.php — saved settings take precedence, constants are the fallback. SEARCHX_SEND_ORDERS and SEARCHX_WAIT_FOR_COOKIE_CONSENT (true or false) override their settings.

4. Add the search bar

Add [searchx_bar] wherever your storefront search box should appear: a header template part, widget area, navigation/menu builder area, page-builder block, or a regular page or post.

5. Create the search results page

Create a page containing [searchx_page] — for example a page named “Search”. If its path is not /searchx (the plugin default), go to WooCommerce → Settings → SearchX and set Search page path to your page’s path (e.g. /search).

6. Test your search

Open the storefront and type a product keyword — instant results should appear as you type. Try a misspelled query to see typo tolerance, open the full results page and try the filters, then test on mobile.

The full illustrated guide, including troubleshooting, lives in the documentation.

FAQ

Do I need a SearchX account?

Yes. The plugin is a connector for the SearchX service — a 14-day free trial is available, no credit card required. Paid plans start at €49/month (Core, up to 20,000 products) with unlimited searches.

How do my products get into SearchX?

Through an XML product feed (Google Merchant Center, Facebook or Skroutz format) that you connect in the SearchX admin — this is required for the plugin to show results. SearchX imports the feed and re-syncs it automatically on the schedule you choose (hourly or daily). The plugin does not read or sync the WooCommerce product database directly. No feed yet? Any WooCommerce product-feed plugin that outputs one of these formats works. Make sure the feed’s product IDs match your WooCommerce product IDs so add-to-cart works.

Where do I manage the catalog, synonyms, merchandising and analytics?

In the SearchX admin (admin.searchxengine.ai). The plugin’s settings tab (WooCommerce → Settings → SearchX) controls credentials, request mode, caching and widget behaviour/appearance; feed sync, synonyms, custom filters, pinned products, top searches, suggested links, custom widget CSS, custom translations and analytics live in the SearchX dashboard.

Proxy or direct mode — which should I use?

We recommend direct mode (Direct to SearchX): searches go straight from the browser to SearchX with a public browser key that can only search, and only from your website’s origin — one hop fewer and no search traffic on your WordPress server. Create the key in the SearchX admin: API Keys → New key → Public browser search. Proxy mode (Through WordPress, the plugin’s default setting) sends searches through a thin REST endpoint on your site instead: your full API key never reaches the browser and each shopper gets their own rate limit.

Will it slow down my server?

No. Searches are served by the SearchX cloud. In proxy mode your server only forwards the requests (a thin REST endpoint) so your private API key never reaches the browser; in direct mode it handles no search traffic at all. The plugin can also cache the SDK locally and cache the relatively static search-settings response to reduce repeat downloads and configuration requests. Authentication and search results still run normally and are not cached.

How do I clear the plugin cache?

Open WooCommerce → Settings → SearchX and use Clear SearchX cache. This clears the cached search settings and the local SDK copy; the next page load uses the configured fallback and refresh process.

Can I add my own filters?

Yes. SearchX picks up the extra attributes in your XML feed on import (custom tags, g:product_detail, custom_label_0–custom_label_4 and more). Enable the ones you want in the SearchX admin under Settings → Feed (Feed attributes), give them your own labels per language, and choose their order.

Can I show one result per product instead of every size or colour?

Yes. If your feed lists each variant as its own item (Google and Facebook feeds do), turn on Group product variants in the SearchX admin (Settings → Content, Product Visibility) to show one result per product page.

Can I see the sales that came from search?

Yes. The Sales from search card in the SearchX dashboard shows paid orders and revenue from search next to your store’s total. Turn on Send orders to SearchX under WooCommerce → Settings → SearchX (it needs your private API key). The plugin saves the shopper’s search session on the order at checkout, classic or block, and sends the order from your server in the background once it is paid: Processing or Completed, and cash on delivery only once Completed. Cancelled and refunded orders are sent again so they drop out. If you pasted SearchX’s Sales from search code into your theme before, remove it: while it is there the plugin leaves orders to it, so nothing is sent twice.

Does SearchX need cookie consent?

SearchX’s session cookies count as statistics cookies in many jurisdictions. Turn on Wait for the shopper’s consent and no SearchX cookie is set until the shopper allows statistics cookies. With the WP Consent API plugin and a compatible cookie banner this happens automatically; with any other banner, call window.searchxSetCookieConsent(true) when the shopper agrees (and false if they withdraw). Search works either way; without consent an order simply counts in the total only.

Does it work with my theme?

The shortcodes render standard containers the SDK mounts into, so any theme that renders shortcodes works — including block themes. To restyle the widget, upload or link your custom CSS in the SearchX admin — the widget applies it automatically.

How do add-to-cart and wishlist work?

Add-to-cart uses WooCommerce’s native ?add-to-cart=PRODUCT_ID&quantity=1 flow — the SearchX product unique_id must be the WooCommerce product ID (set this in your XML feed). Wishlist is handled automatically when YITH WooCommerce Wishlist is active; otherwise the SearchX:woocommerceAddToWishlist JavaScript event is fired so your theme can handle it.

How large a catalog can it handle?

Core covers up to 20,000 products, Growth up to 50,000 and Scale up to 100,000; above that, Enterprise is a custom quote. The free trial indexes up to 20,000 products on every plan.

What about the AI features?

AI semantic matching and Ask AI are in beta and optional. SearchX adds no extra charge, but they require your own OpenAI API key (usage billed by OpenAI). Standard search works fully without them.

Where is my data processed?

See the “External services” section above. Search queries and anonymous analytics events are processed by the SearchX service; no customer names, emails or account data are read from your store.

Screenshots

Changelog

2.7.0

  • New: Send orders to SearchX. Paid orders feed the Sales from search card with no code to paste. Off by default; orders are sent from your server in the background with your private API key, and no customer details are sent.
  • New: Wait for the shopper’s consent before setting SearchX cookies. Follows the WP Consent API (statistics), or window.searchxSetCookieConsent(true) from any cookie banner.
  • Direct to SearchX is now the recommended mode in the settings, with the steps to create a public browser key. Saving Direct without a public browser key is refused, so the storefront is never left without search. Saved settings are not changed by the update.
  • If SearchX’s hand-pasted Sales from search code is still installed, the plugin leaves orders to it and asks you to remove it, so no order is sent twice.

2.6.2

  • Proxy mode now forwards each shopper’s IP to SearchX, so shoppers are rate-limited individually instead of the whole store sharing one limit.
  • Preconnect to the configured API origin on pages loading SearchX in direct mode. Proxy mode is unchanged.
  • Tested with WooCommerce 11.3.

2.6.1

  • Uninstalling now also removes the public browser key and request mode settings.
  • The SDK cache is checked at most once per refresh interval, including after a failed download, instead of on every page load.
  • Search settings requests through the proxy ignore query parameters, so arbitrary query strings cannot bypass or grow the settings cache.

2.6.0

  • Added optional direct SearchX requests using a restricted public browser key.
  • Proxy mode remains the default and continues to keep the private API key server-side.
  • Added backend-enforced public key scope and website-origin restrictions.

2.5.2

  • Added configurable popup results per page (5–50, default 20).
  • Added configurable attributes to retrieve and highlight.
  • Added configurable server-side search-settings caching with stale-while-revalidate, hard maximum age and manual clear action.
  • Added optional local SDK caching in the plugin’s static cache directory with periodic update checks and CDN fallback.
  • Added SHA-256 manifest verification before replacing the locally cached SDK.
  • Added a setting to disable site-wide SDK loading and use shortcode-triggered loading instead.
  • Authentication, search responses and CSS remain uncached.

2.5.1

  • Initial release on WordPress.org.
  • [searchx_bar] / [searchx_page] shortcodes with multi-root support.
  • Server-side API proxy — the private API key is never exposed to the browser.
  • WooCommerce settings tab with credentials, layout, popup, product-card, filter and label options.
  • Native WooCommerce add-to-cart and YITH wishlist integration.
  • HPOS and Cart/Checkout blocks compatibility declarations.