SwiftSearch for Typesense

Custom Fields and Faceted Sidebar Navigation

Give users the power to filter results instantly. Map any custom meta fields (such as Price, Brand, SKU, or custom metadata fields) and build multi-select facet filters using our visual drag-and-drop layout builder.

Background Sync and Real-Time Updates

When you first connect, our background sync engine processes your content in self-scheduling batches to prevent script timeouts. Once indexed, any new, updated, or deleted posts/products are synchronized.

Native WP-CLI Command-Line Integration

For stores with large catalogs (10,000+ items) or servers with strict security firewalls that block background HTTP requests (loopback blocks), SwiftSearch includes full WP-CLI terminal commands. Run bulk indexing ( wp swift-search index ), check connection status ( wp swift-search status ), and reset indexes ( wp swift-search reset ) directly via SSH.

Dedicated Shop & Catalog Page Mode

Easily replace your default WooCommerce Shop page with a high-performance, dedicated search and filter catalog page. Features horizontal sort filters, instant category sidebar counts, pagination, and a clean flat card layout.

Page Builder Friendly

Customize the search UI without writing code. Control colors, typography, card layouts, and toggles (show/hide prices, thumbnails, and excerpts) directly from the settings. It works with Elementor, Divi, Gutenberg, or any page builder via a lightweight shortcode [swift_search] .

Features & Technical Capabilities

• Instant Autocomplete : Displays matching products and posts the moment visitors start typing.
• Faceted Navigation & Filters : Create and manage multi-select sidebar filters for taxonomies and metadata.
• Merchandising & Pinning : Fix specific items to the top of results for a curated user experience.
• Result Weighting & Tuning : Tune field importance (e.g., prioritize SKU hits over Content).
• Global Synonym Sets : Integrated synonym architecture (compatible with Typesense v0.30+).
• Advanced Custom Fields Mappings : Search and filter by custom fields (Price, SKU, Brand, etc.).
• Search Analytics : Dashboard for tracking popular searches and identifying “Zero Result” gaps.
• Background Indexing : Sync engine handles items in self-scheduling batches without timing out.
• Automated Sync : Real-time indexing when you Save, Update, or Delete content.
• WP-CLI Support : Bulk sync, reset, and check connection status from your terminal via SSH.
• CPT Support : Index Posts, Pages, Products, and Custom Post Types.
• Easy Setup (No Coding Required) : Configure search layouts, color schemes, and settings visually without writing code.
• Global UI Toggles : Show or hide Thumbnails, Prices, and Excerpts globally.
• WooCommerce Search : Optimized for product titles, prices, and product imagery.
• Translation Ready : Works perfectly with multilingual websites and translation plugins.
• Mobile Ready : Fits perfectly on all screens, including phones, tablets, and desktops.
• SEO Optimized : Keeps your website light and fast, which helps improve your Google search rankings.
• Fast & Secure : Loads search results instantly while keeping your customer data fully secure.
• Automatic Updates : Receive new features and security fixes automatically right inside your dashboard.
• Full Search Replacement : Replace the default, slow WordPress search sitewide with a single click.
• Easy Placement : Put custom search bars anywhere on your site using simple shortcodes.
• Page Builder Ready : Integrates with Elementor, Divi, and Gutenberg blocks using shortcodes or automatic form replacement.
• Developer Customizable : Built with clean standards and standard hooks/filters for advanced customization.

Developer Customization

SwiftSearch is built with custom DOM event dispatching to allow advanced integrations with third-party themes and plugins (e.g. Wishlists, Ajax Add-to-Cart, or Quick View).

JavaScript Event Hooks

You can listen to these custom events on the document or the wrapper element:

1. 01swift-search:hit-rendered – Dispatched for every individual hit/card element that is rendered. event.detail.hit : The raw search hit data from Typesense.
2. 02event.detail.card : The DOM element node of the rendered card.
3. 03event.detail.collection : The collection name (e.g. posts , terms , users ).
4. 04swift-search:results-rendered – Dispatched after the entire search grid and all sections have completed rendering. event.detail.data : The raw search results payload returned from Typesense.
5. 05event.detail.totalFound : Total organic hits count.

Code Example

document.addEventListener('swift-search:hit-rendered', function(e) { if (e.detail.collection === 'posts') { const card = e.detail.card; const hitData = e.detail.hit; // Inject rating badges or custom hooks } });

WordPress PHP Filters

Backend developers can customize data synchronization and query configurations using WordPress filters:

1. 06swift_search_post_document – Filters the structured document data before it is sent/synced to Typesense. Use this to add custom meta fields, dynamic stock rules, or text content modifications. Arguments: $document (array), $post_id (int), $post (WP_Post object).
2. 07Code Example (Complex Meta, HTML Sanitization & Array Handling): add_filter(‘swift_search_post_document’, function($document, $post_id, $post) { // Fetch complex custom fields (e.g. using helper functions if available) if (function_exists(‘get_field’)) { $brand = get_field(‘brand_name’, $post_id); if ($brand) $document[‘brand’] = $brand; } // Strip HTML/shortcodes from WYSIWYG content $wysiwyg = get_post_meta($post_id, ‘hero_wysiwyg’, true); if ($wysiwyg) { $document[‘hero_text’] = wp_strip_all_tags(strip_shortcodes($wysiwyg)); } // Flatten array values for flat target fields $colors = get_post_meta($post_id, ‘colors’, true); if (is_array($colors)) { $document[‘colors_list’] = implode(‘, ‘, $colors); } return $document; }, 10, 3);
3. 08swift_search_should_index_post – Filter returning a boolean. Return false to completely exclude specific posts, drafts, or out-of-stock products from the search index. Arguments: $should_index (bool), $post_id (int), $post (WP_Post object).
4. 09swift_search_vars – Filters the configuration variables passed from PHP to the frontend JavaScript (such as API keys, weights, and enabled facets). Arguments: $vars (array), $settings (array).
5. 10swift_search_shortcode_args – Filters default shortcode attributes and display settings. Arguments: $args (array), $atts (array).

Privacy & Compliance

SwiftSearch is designed with a “Privacy First” architecture: – Zero Middleware : We do NOT use any proxy or Loopstates-hosted servers. Search queries go directly from the user’s browser to your Typesense cluster. – Self-Contained : All configuration, analytics data, and result pinning rules are stored locally in your WordPress database. – GDPR Ready : Since you control the Typesense node, you maintain full ownership of the search logs and user data flow. – 100% Free & Open Source : No telemetry, no third-party data disclosure, and no licensing hooks.

Known Limitations

1. 11Search-Only Keys : For public-facing sites, we recommend using a “Search Only” API key from Typesense for frontend queries. Using your Admin key on the frontend is a security risk.
2. 12Schema Sensitivity : Changing core settings (like adding a new Facet or Custom Field) modifies the underlying Typesense schema. A full Re-Index (Step 8) is required after such changes.
3. 13Background Sync : Initial indexing of large catalogs (10k+ items) can take a few minutes via the sync engine.