Search Autocomplete for Magento 2

Intelligent search autocomplete for Magento 2 — instant AJAX results with product suggestions, SKU search, description matching, category & CMS page results, layered navigation of result sections, and fully configurable result counts. Works flawlessly on both Hyva and Luma themes with engine-agnostic support for Elasticsearch 7/8, OpenSearch, and the MySQL fallback search engine.

Panth Search Autocomplete turns the sluggish stock Magento search box into a lightning-fast, conversion-focused shopping assistant. As shoppers type, the dropdown instantly surfaces matching products (with images and prices), related categories, CMS pages, and popular searches — all via debounced AJAX calls that bypass full page loads. Every result section can be toggled, limited, and styled independently, giving merchandisers complete control over what shoppers see first.

The module searches across product name, SKU, short description, and full description using Magento's configured search engine, so results stay consistent with the on-site search results page. A dedicated cache type, 9-layer bot protection (form-key validation, per-IP rate limiting, query length caps, honeypots), and full keyboard & ARIA accessibility keep it fast, secure, and inclusive. Whether you run a high-traffic Luma storefront or a modern Hyva + Alpine.js build, Panth Search Autocomplete drops in with zero frontend conflicts.

Get a free quote for your project in 24 hours — custom modules, Hyva themes, performance optimization, M1→M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

• Key Features
• How It Works
• Compatibility
• Installation
• Configuration
• Search Fields & Matching
• Bot & Abuse Protection
• Performance & Caching
• Hyva & Luma Theme Support
• Troubleshooting
• FAQ
• Support
• About Panth Infotech
• Quick Links

Instant AJAX Autocomplete

• Live results as you type — debounced AJAX requests (default 200ms) fire after the minimum query length is met
• Product suggestions with images & prices — show thumbnail, name, price, SKU and short description per hit
• SKU search — match exact or partial SKUs so B2B customers can find products by code
• Description matching — searches short and long descriptions, not just the product name
• Category suggestions — surface matching category links so shoppers can jump directly to listings
• CMS page suggestions — show matching pages (about, shipping, FAQ) right inside the dropdown
• Popular & recent searches — display trending queries when the input is empty or too short
• Layered result navigation — each result section (products / categories / pages / popular) is an independent block with its own limit and visibility toggle

Merchant Controls

• Configurable result count — independent products_limit, categories_limit, pages_limit, and popular_limit
• Min / max query length — default 2–64 characters (hard cap prevents DoS via huge queries)
• Debounce interval — tune request frequency between responsiveness and server load
• Show / hide product images, prices, category section, CMS section, popular section — all per store view
• Engine-agnostic — uses whatever search engine Magento is configured with (Elasticsearch 7, 8, OpenSearch, or MySQL fallback)

Security & Performance

• 9 layers of bot protection — form-key validation, per-IP rate limiting, query length caps, honeypot fields, referer checks, and more
• Dedicated cache type — panth_search_autocomplete cache is auto-invalidated on catalog / CMS changes
• Lightweight frontend — no jQuery dependency on Hyva, Alpine.js-powered; graceful Luma KnockoutJS implementation
• ARIA-accessible markup — full keyboard navigation (arrow keys, Enter, Escape) and screen-reader support

Developer-Friendly

• MEQP compliant — passes Adobe's Magento Extension Quality Program
• PSR-12 code style — clean, documented, fully typed
• Composer-installable — no manual file copying
• Zero third-party dependencies — uses only Magento framework classes

1. Shopper types in the search box.
2. JavaScript debounces input (configurable, default 200ms) and validates minimum length.
3. AJAX request hits /panth_searchautocomplete/ajax/index with the form key.
4. Controller validates form key, checks per-IP rate limit, and normalises the query.
5. Cache layer is checked — if hit, response is returned in <5ms.
6. On cache miss, the module queries Magento's configured search engine across name, SKU, short description and description fields.
7. Results are assembled into sections (products, categories, CMS pages, popular searches), each respecting its own limit.
8. JSON response is cached and rendered into the dropdown via Alpine.js (Hyva) or Knockout (Luma).

Composer Installation (Recommended)

composer require mage2kishan/module-search-autocomplete
bin/magento module:enable Panth_Core Panth_SearchAutocomplete
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release from Packagist or GitHub.
2. Extract to app/code/Panth/SearchAutocomplete/.
3. Ensure Panth_Core is also present in app/code/Panth/Core/ or installed via Composer.
4. Run the enable / upgrade commands above.

Verify Installation

bin/magento module:status Panth_SearchAutocomplete
# Expected output: Module is enabled

After installation, navigate to:

Admin → Stores → Configuration → Panth Extensions → Search Autocomplete

All settings live at Stores → Configuration → Panth Extensions → Search Autocomplete.

General

Result Sections

Caching

Bot & Abuse Prevention

Panth Search Autocomplete queries the following product attributes through Magento's configured search engine:

• Name — primary match
• SKU — exact and partial matches (critical for B2B stores)
• Short Description — keyword matching
• Description — full-text matching
• URL Key — fallback for slug-based queries

Category suggestions match against category name and description. CMS page suggestions match title and content heading. All matching honours store view scope, website scope, and visibility / status flags — out-of-stock and disabled products never appear.

Search endpoints are a favourite target for scrapers and DoS attackers. Panth Search Autocomplete ships with 9 defensive layers enabled by default:

1. Form-key validation — rejects requests without a valid Magento session form_key.
2. Per-IP rate limiting — configurable requests/minute, backed by Magento cache.
3. Query length cap — max_query_length rejects oversized payloads.
4. Minimum query length — blocks 1-character fishing queries.
5. Honeypot field — hidden input that bots fill in but humans cannot.
6. Referer validation — rejects cross-origin requests from non-storefront referers.
7. User-agent heuristics — flags known scraper signatures.
8. Response caching — repeated identical queries never re-hit the search engine.
9. Query normalisation — strips control characters, collapses whitespace, lowercases.

A dedicated cache type keeps autocomplete responses blazingly fast:

• Cache key — derived from store_id + query_hash + config_hash
• Auto-invalidation — on product save, category save, CMS page save, and config change
• Cache type — panth_search_autocomplete (listed in Admin → System → Cache Management)
• Typical response time — <5ms on cache hit, 30–80ms on Elasticsearch miss

To manually flush:

bin/magento cache:clean panth_search_autocomplete

Hyva Theme

• Alpine.js + Tailwind CSS — no jQuery, no KnockoutJS
• Zero CLS — dropdown uses absolute positioning with reserved dimensions
• Works with Hyva Checkout — no conflicts with the Hyva ecosystem

Luma Theme

• Native KnockoutJS integration — matches stock Magento component style
• LESS theming — inherits your theme colours via CSS variables
• Magento UI Library — uses standard _ui.less mixins

Both implementations share the same backend controller and respond to the same configuration options, so merchants can switch themes without retraining.

Does Panth Search Autocomplete work with Elasticsearch and OpenSearch?

Yes. The module is engine-agnostic — it uses whatever Magento is configured with (Elasticsearch 7, Elasticsearch 8, OpenSearch 1.x/2.x, or the MySQL fallback). No extra setup required.

Does it search by SKU?

Yes. SKU is a first-class search field. Both exact and partial SKU matches are returned, which is essential for B2B and wholesale storefronts.

Can I limit how many products, categories, or CMS pages are shown?

Yes. Each result section has an independent limit in the admin. Set any section's limit to 0 (and its visibility toggle to "No") to hide it entirely.

Does it work on Hyva?

Yes — the module ships with a dedicated Hyva implementation using Alpine.js and Tailwind CSS. No jQuery, no KnockoutJS, zero Hyva compatibility issues.

How does the rate limiting work?

Requests are counted per IP per minute, stored in Magento's default cache. Cache-served responses do not count against the limit, so frequent queries from a legitimate shopper stay fast. Abusive bots are blocked with a 429 response.

Does it slow down my store?

No. The dedicated cache, debouncing, and lightweight frontend mean typical response times stay under 10ms for cached queries. The dropdown adds no weight to initial page load — all assets are lazy-loaded when the search input is focused.

Is Panth Core required?

Yes. Panth Core is the free foundation module for all Panth extensions. Composer installs it automatically.

Does it support multi-store / multi-website setups?

Yes. All settings respect Magento's standard scope hierarchy (default → website → store view). Each store view can have its own limits, debounce, and visibility toggles.

Response time: 1-2 business days.

Need Custom Magento Development?

Built and maintained by Kishan Savaliya — kishansavaliya.com — a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency specializing in high-quality, security-focused extensions and themes for both Hyva and Luma storefronts. Our extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management — over 34 modules built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on the Adobe Commerce Marketplace or Packagist.

• Website: kishansavaliya.com
• Get a Quote: kishansavaliya.com/get-quote
• Upwork Profile (Top Rated Plus): upwork.com/freelancers/~016dd1767321100e21
• Upwork Agency: upwork.com/agencies/1881421506131960778
• Packagist: packagist.org/packages/mage2kishan/module-search-autocomplete
• GitHub: github.com/mage2sk/module-search-autocomplete
• Adobe Marketplace: commercemarketplace.adobe.com
• Email: kishansavaliyakb@gmail.com
• WhatsApp: +91 84012 70422

Ready to supercharge your Magento 2 search experience?

SEO Keywords: magento 2 search autocomplete, instant search, ajax search, search suggestions, product autocomplete, magento 2 live search, magento 2 ajax search extension, magento 2 sku search, magento 2 search by description, magento 2 layered navigation search, magento 2 elasticsearch autocomplete, magento 2 opensearch autocomplete, hyva search autocomplete, luma search autocomplete, magento 2 search dropdown, magento 2 predictive search, magento 2 search suggestions extension, magento 2 product search box, magento 2 popular searches, magento 2 recent searches, magento 2 search performance, magento 2 search bot protection, magento 2 search rate limit, panth search autocomplete, panth infotech magento, kishan savaliya magento, mage2kishan search autocomplete, top rated plus magento developer, hire magento developer upwork, magento 2.4.8 search extension, php 8.4 magento module