WooCommerce Search Integration

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