wordpress/Search Settings

Search Settings

Configure how Intufind's AI-powered search works on your WordPress site.

🔍

New: Search Widget

Add an instant search overlay to your site with keyboard shortcuts and customizable triggers. Learn more →

Zero Configuration Required

Intufind automatically replaces WordPress's default search — no code changes or theme modifications needed.

Once activated, any existing search form on your site (header search, sidebar widgets, WooCommerce product search) instantly uses AI-powered semantic search instead of WordPress's basic keyword matching.

Works with your existing setup

  • Existing search forms work automatically
  • Search URLs (?s=query) are intercepted
  • Theme templates don't need changes
  • WooCommerce product search included

Navigate to Intufind → Search to access these settings.

Search Settings Screenshot: wp-search-settings.png

Enable Semantic Search

Default: On

When enabled, Intufind uses AI-powered semantic search that understands context and intent, not just keywords.

Semantic SearchTraditional Search
Understands meaningMatches exact words
"warm jacket for hiking" → finds insulated outdoor gearOnly finds items containing those exact words
Handles typos gracefullyTypos return no results
Natural language queries workKeyword-only queries

Recommendation: Keep this enabled for the best search experience.

Enable Mixed Content Search

Default: On

Allow general site searches to include products alongside posts and pages.

  • Enabled: A search for "guide" might return both blog posts about guides AND products with "guide" in the title
  • Disabled: General searches only return posts and pages; product searches remain separate

Use case for disabling: If you want to keep product search completely separate from blog/page search.

Enable Enhanced AI Search

Default: Off

Adds AI agents for complex, multi-criteria queries. This is an advanced feature for sophisticated search needs.

When Enhanced AI Search Helps

Enhanced AI Search activates automatically for complex queries:

  • Complex filters: "Show me red Nike shoes under $100 in stock"
  • Comparative queries: "Compare wireless headphones vs wired ones"
  • Multi-criteria: "Best rated laptops for gaming under $1500"

Cost Consideration

Enhanced AI Search costs 3x more credits than standard search, but only when AI agents are triggered by complex searches. Simple searches like "laptop" or "red shoes" work perfectly with standard Intufind search and don't trigger the additional cost.

Think of it like this: Standard search is like having a smart librarian who understands what you mean. Enhanced AI search adds a team of specialists who can break down complex requests and apply multiple filters.

Search Cache Duration

Default: 3600 seconds (1 hour)

How long to cache search results before refreshing from the AI.

DurationUse Case
60 secondsFrequently changing inventory
3600 seconds (1 hour)Balanced performance (recommended)
86400 seconds (24 hours)Rarely changing content

Trade-off: Longer cache = faster searches but potentially stale results. Shorter cache = fresher results but more API calls.


Search Widget

The Search Widget is an instant search overlay that provides a modern, keyboard-friendly search experience — similar to the search found in tools like Notion, Slack, and VS Code.

Navigate to Intufind → Search → Widget to configure.

Search Widget Settings Screenshot: wp-search-widget-settings.png

Enable Search Widget

Default: Off

When enabled, the search widget adds:

  • Keyboard shortcut (Ctrl+K / ⌘K) — Opens search from anywhere on your site
  • Instant results — Shows products and content as you type
  • Optional floating button — Visual trigger for discoverability

Search Scope

Choose what content types to include in widget search results:

OptionDescription
Search ProductsInclude WooCommerce products with faceted filtering
Search PostsInclude blog posts, pages, and other indexed content

You can enable both, or just one depending on your site's focus.

Trigger Settings

Keyboard Shortcut

Default: Ctrl+K / ⌘K

Users can press this keyboard combination anywhere on your site to open the search overlay.

ShortcutWindows/LinuxMac
Ctrl+KCtrl+K⌘K
Ctrl+/Ctrl+/⌘/
Ctrl+Shift+FCtrl+Shift+F⌘⇧F

Floating Trigger Button

Default: On (but auto-hidden when Chatbot is enabled)

Displays a floating search icon button for users who prefer clicking to keyboard shortcuts.

💡

Smart behavior

When both the Chatbot and Search Widget are enabled, the floating search button is automatically hidden to avoid visual clutter. Users can still access search via keyboard shortcut or shortcode buttons.

Button Position Options:

  • Bottom Left (recommended — avoids chatbot)
  • Bottom Right
  • Top Left
  • Top Right

Appearance

SettingDescription
Color SchemeLight, Dark, or Auto (follows system preference)
Primary ColorAccent color for the trigger button and highlighted elements

Shortcode

Place a search button anywhere using the [intufind_search] shortcode.

Basic Usage

[intufind_search]

Renders a "Search" button with a search icon.

Custom Text

[intufind_search text="Find Products"]

Icon Only

Perfect for navigation bars:

[intufind_search icon_only="true"]

With Custom CSS Class

[intufind_search text="Search" class="my-custom-btn"]

Pre-filled Query

Open search with a specific query:

[intufind_search text="Find Shoes" query="shoes"]

JavaScript API

For theme developers, the search widget exposes a JavaScript API:

// Open search overlay
window.IntufindSearch.open();

// Open with pre-filled query
window.IntufindSearch.open('running shoes');

// Close search overlay
window.IntufindSearch.close();

// Toggle search overlay
window.IntufindSearch.toggle();

Example: Header Search Button

Add a search icon to your theme's navigation:

// In your theme's header.php or via a custom plugin
<nav class="main-nav">
  <a href="/">Home</a>
  <a href="/products">Products</a>
  <a href="/blog">Blog</a>
  <?php echo do_shortcode('[intufind_search icon_only="true" class="nav-search-btn"]'); ?>
</nav>

How Search Works

  1. Visitor searches → Query sent to Intufind
  2. AI processing → Understands intent and meaning
  3. Smart matching → Finds relevant content by meaning, not just keywords
  4. Results returned → Ranked by relevance

Results are cached according to your cache duration setting.

Troubleshooting

Search returns no results

  1. Check that content is indexed (Intufind → Status)
  2. Verify the content type is enabled (Intufind → Indexing)
  3. Ensure Semantic Search is enabled

Search is slow

  1. Increase cache duration
  2. Check your internet connection
  3. Review Status page for API connectivity

Wrong results appearing

  1. Re-sync affected content types
  2. Check product/post descriptions are accurate
  3. Review excluded categories in Indexing settings

Next Steps