Search Autocomplete for Magento 2
Show product suggestions, category links, CMS pages and popular searches as shoppers type. Configure result limits, images, prices and the minimum query length, with additional SKU matching.
- Free
- Themes listed: Hyvä + Luma
composer require mage2kishan/module-search-autocomplete
- Package requirementsRead the source documentation
- Developer profileView Upwork profile
- Themes listedHyvä + Luma
- PHP versions listed8.1, 8.2, 8.3, 8.4
- Installation questionsDiscuss your store setup
What it does for your store
The main features, as listed in the module documentation.
-
Show suggestions while typing
Help shoppers choose products, categories, CMS pages or popular search terms from the suggestion panel.
-
Choose groups and limits
Set result limits, image and price display, minimum query length and the delay between requests.
-
Supplement product matching
Add SKU matches when configured search results leave room in the product list.
-
Review your storefront integration
Check the search field, dropdown and keyboard controls with your header, theme and customer groups.
Installation
Example commands from the Magento root. Follow the package instructions and your staging and deployment process.
- 1Check the releaseMatch Magento, PHP, theme and dependency requirements.
- 2Install on stagingReview Composer changes and follow the package instructions.
- 3Configure and verifyUse the documented settings and test the affected features.
$ composer require mage2kishan/module-search-autocomplete $ bin/magento setup:upgrade $ bin/magento setup:di:compile $ bin/magento setup:static-content:deploy -f $ bin/magento cache:clean
Listed requirements
These are the details supplied in this listing. Confirm the selected release supports your Magento edition, PHP and storefront.
| Magento versions listed | 2.4.6, 2.4.7, 2.4.8 |
|---|---|
| PHP versions listed | 8.1, 8.2, 8.3, 8.4 |
| Themes listed | Hyvä, Luma |
| Composer package | mage2kishan/module-search-autocomplete |
Documentation
Product details and setup guidance. Check the package repository for release-specific instructions.
Help shoppers choose a search destination sooner
Search Autocomplete adds a suggestion panel to the storefront search experience. Shoppers can see matching products and follow a relevant result while typing, or continue to the full search results page. You control which result groups appear and how much space each receives.
A useful panel should answer a simple question: where can I go next? Product images and prices can help distinguish similar items, while category and CMS page links give visitors another route when they are looking for a collection or information rather than one product.
Choose the result groups your store needs
- Products with optional images and price display.
- Categories from the active store's catalogue tree.
- Active CMS pages assigned to the current store.
- Popular search terms and a link to view all results.
Each result group has its own limit or display control. Set a minimum query length and a debounce delay so the panel waits briefly between requests. The installed defaults begin suggestions at two characters with a 200 millisecond delay; they are configuration defaults, not a response-time guarantee.
Understand how product matching works
The product provider starts with Magento's configured search collection. When it has fewer results than the configured limit, it can supplement the response with SKU matches. A further vocabulary-based expansion can suggest related spellings when the earlier steps do not fill the result set.
This extends the suggestion experience around your existing catalogue search. Keep your supported search engine configured and indexes healthy. Check your own catalogue terms, SKU formats and common misspellings in staging, particularly if another extension changes search behaviour or product visibility.
Category matching checks names and can supplement them with description matches. CMS page suggestions look across page content and metadata while excluding several system pages. Review those results against the pages you want shoppers to discover.
Fit the panel to your storefront
The package includes frontend templates for Hyva and Luma integration, and the JavaScript contains keyboard controls for moving through suggestions, choosing a result and closing the panel. Test the final search field and dropdown with your active header, custom theme and any other search extension.
Requests have configurable form-key, origin, header and rate-limit checks. These are request controls, not a promise to block every bot or prevent all abuse. The suggestion cache varies by store, customer group and query; stores with additional customer-specific pricing or visibility rules need an integration review.
Install and verify against real searches
Version 1.1.8 is supplied as mage2kishan/module-search-autocomplete. It requires mage2kishan/module-core ^1.0 and declares PHP 8.1 through 8.4 constraints plus its Magento module dependencies. Confirm the complete dependency set for your Magento release before installation.
From the Magento root on staging, install with composer require mage2kishan/module-search-autocomplete. Check bin/magento module:status Panth_Core Panth_SearchAutocomplete and enable those modules if needed before your normal upgrade, compilation and static-content deployment steps. Use bin/magento cache:clean after deployment.
Open Stores > Configuration > Panth Extensions > Search Autocomplete to choose query settings, result groups, cache settings and request controls. The Admin menu also has Panth Infotech > Search Autocomplete > Documentation for module guidance.
After installation, check a product name, a complete SKU, a partial query, a misspelling and a query with no matches. Check out-of-stock behaviour and guest versus customer-group results where relevant. Keystroke popularity recording is optional and disabled by default.
For help reviewing a custom search setup or installation requirements, contact Kishan. Installation or bespoke integration work is separate from the module download and should have an agreed scope and fee.
Developer integration
Panth\SearchAutocomplete\ViewModel\SearchBox supplies the search templates with configuration and endpoint URLs. The package includes Panth_SearchAutocomplete::searchbox.phtml for Luma and Panth_SearchAutocomplete::hyva/searchbox.phtml for Hyva. Review the active header layout and theme overrides before changing the search field or adding another instance.
The suggestion endpoint is generated by SearchBox::getEndpointUrl(). Use the existing templates and request configuration when integrating a custom header, and check keyboard behaviour, store context and customer-group results on staging.
Read the package README and setup and usage guide, matching the instructions to your selected release.
| Module Category | Search |
|---|---|
| Best For | All Sizes |
Changelog
-
1.0.0, Initial release
- Engine-agnostic product search via Magento\Catalog\Model\Layer\Resolver
- Direct SKU LIKE fallback so customers can find products by typing literal SKU codes (MJ12, 24-WB04).
- Dynamic catalog vocabulary built from the merchant's own product names, substring containment, Levenshtein typo tolerance, and metaphone phonetic matching for any catalog vocabulary, no hard-coded synonyms.
- Category search by name AND description (two-pass design).
FAQ
Does Panth Search Autocomplete work with Elasticsearch and OpenSearch?
Product suggestions start with Magento's configured search collection. When results leave room, the provider can add SKU matches, then try vocabulary-based query expansion. Use the Elasticsearch or OpenSearch version supported by your Magento release and test your search integration on staging.
Does it search by SKU?
Yes. When configured search results do not fill the product limit, the provider can add SKU matches. Test full and partial SKUs from your catalogue, including product visibility and stock settings.
Can I limit how many products, categories, or CMS pages are shown?
Yes. Set the result limits and display controls for products, categories, CMS pages and popular searches. Category and CMS page suggestions return no results when their limit is zero or their display setting is off. Check the panel at narrow screen widths.
Does it work on Hyva?
The package includes a Hyva searchbox template and layout integration. Check the final field, keyboard controls and dropdown with your actual header. Theme overrides and other search extensions may need integration adjustments.
How does the rate limiting work?
The limiter stores a rolling request window in Magento cache for each client IP and store. Its default is 60 requests per minute, and it checks requests before the suggestion-result cache, including cache hits. Requests exceeding the configured limit receive HTTP 429. Review the setting alongside your proxy configuration and other request controls.
Does it slow down my store?
The module adds suggestion requests and result rendering. A configurable delay between requests and a suggestion cache help manage that work. Measure the final integration with your catalogue, search engine, theme and cache configuration before release.
Is Panth Core required?
Yes. Version 1.1.8 requires mage2kishan/module-core ^1.0 through Composer. Resolve the full dependency set and enable the required modules through your normal installation process.
Does it support multi-store / multi-website setups?
Providers use the current store and Magento configuration scope. The result cache separates entries by store, customer group and query. Check the settings and results for each store and website, and review any extra customer-specific pricing or visibility rules before using a shared suggestion cache.
Questions before you install?
Send me your composer.json and I will check for conflicts first. Free. Installation is +$45, custom work is quoted first.