Skip to main content

Help Center

< Back
You are here:
Print

WooCommerce Search Integration

Created On
Last Updated On
by

Overview

ExpertRec integrates with WooCommerce to provide AI-powered search, autocomplete, and faceted filtering for your online store. It works alongside your existing WooCommerce product catalog and syncs product data automatically via webhooks.

Installation Option A: WordPress Plugin (Recommended)

  1. In WordPress Admin, go to Plugins > Add New
  2. Search for “WP Fastest Site Search”
  3. Click Install Now, then Activate
  4. Go to Settings > ExpertRec Search
  5. Enter your ExpertRec Site ID (found in your ExpertRec dashboard under Install Settings)
  6. Click Save — the plugin automatically detects WooCommerce and begins syncing products

Installation Option B: Manual Code Integration

If you prefer not to use the plugin, add the ExpertRec embed code directly to your theme:

  1. Copy the embed code from ExpertRec Dashboard > Install Settings
  2. In WordPress Admin, go to Appearance > Theme Editor > footer.php
  3. Paste the code before the </body> tag
  4. Click Update File

Product Data Sync

The plugin automatically configures WooCommerce webhooks to keep your search index up to date:

  • Supported webhook events: product.created, product.updated, product.deleted, order.completed
  • Variable products: All product variations are synced and searchable
  • Product attributes: Size, color, material, and other WooCommerce attributes are automatically indexed as filterable facets

Custom Field Mapping

Map WooCommerce custom fields to ExpertRec search fields for richer search and filtering:

  1. Go to ExpertRec Dashboard > Field Mapping
  2. Click Add Custom Field
  3. Enter the WooCommerce meta key (e.g., _price, _sale_price, _stock_status, _sku)
  4. Map it to the corresponding ExpertRec field

Common WooCommerce fields to map: _price, _sale_price, _stock_status, _sku, _weight, product attributes (pa_color, pa_size, etc.)

Search Widget Placement

  • Automatic replacement: The plugin automatically replaces the default WooCommerce search form
  • Shortcode: Use [expertrec_search] to place the search box anywhere on your site
  • Widget: Add via Appearance > Widgets > ExpertRec Search Box

Troubleshooting

  • Plugin conflicts: Deactivate other search plugins (SearchWP, Relevanssi, Ajax Search Lite) and test
  • Products missing from search: Check webhook delivery in WooCommerce > Status > Webhooks — look for failed deliveries
  • Styling issues: Use the Custom CSS editor in ExpertRec dashboard to override conflicting theme styles
  • Variable products not showing variants: Ensure product attributes are set to “Used for variations” in WooCommerce product settings
Table of Contents