Smart Search
Show products and categories while shoppers type in your header search, in a list or a wide grid panel with images, prices and optional Add to Cart.
Check it fits your store
Questions about compatibility? Contact us.
Details
Magento Smart Search adds an instant suggestions panel beneath your store's existing header search on desktop and phones. It opens when shoppers click the field or start typing, without a pop-up window, backdrop, or second search field. The standard search form and full results page keep working.
Magento Smart Search features
- Product suggestions: Show images, names, SKUs, and Magento's own prices, including currency, tax, and customer group pricing.
- More ways to find products: Display matching category links, query suggestions, trending and recent searches, and a Did you mean correction, with searched words highlighted.
- Suggestions before typing: Choose popular products, most-clicked products, most-purchased products, or a curated SKU list.
- Catalog-based relevance: Typed searches use your Magento search engine and fulltext index. Equivalent terms, stop words, attribute priorities, and a careful typo retry improve ordering without adding unrelated products.
Product visibility, website, status, stock, and minimum advertised price rules apply.
Layouts and cart actions
Set list or grid layouts separately for desktop and mobile. The grid panel can extend beyond the search field, with a default width of 880 px, a side column for suggestions and categories, and three or four product columns. View all results stays visible at the bottom.
Optional Add to Cart buttons post to Magento's own cart. Products that require a choice open their product page instead.
Ranking that learns from shopper activity
Real clicks, cart additions, and paid invoices move the products shoppers choose higher in the suggestions. Signed-in customers can see products from their own paid orders and related products.
Collect activity automatically or only after explicit opt-in. Shoppers can clear their history, and activity collection stores no names, email addresses, or raw IP addresses.
Included AI answers
Smart Search AI lets shoppers select Ask AI and automatically answers searches that read like questions. Each short answer can include up to three products found in your catalog and an optional better search.
Claude or ChatGPT writes answers through the included AI Content component, which manages the API connection, monthly budget, and usage log. Identical answers can be reused, and a per-visitor limit applies. Searches containing personal data are refused before the AI is called.
AI requirements: Add a Claude or ChatGPT API key in AI Content and allow outgoing HTTPS to the provider. These requirements apply only to AI answers.
Search reporting and keyboard access
The Search Intelligence dashboard under Marketing shows searches, click-through and purchase conversion rates, no-result rate, a daily chart, trending and unmatched searches, products earning attention, and recent search history. Export data as CSV or use Try a search to preview shopper results.
Keyboard controls include arrow keys, Enter, Escape, and Ctrl/Cmd+K. Combobox and listbox roles announce the active option.
Theme compatibility and requirements
One package supports Luma, Luma-based themes, and Hyvä. On Hyvä, the panel opens beneath the theme's own header search and uses its colors through plain CSS custom properties, with no Tailwind rebuild. The script loads deferred without RequireJS, jQuery, or inline scripts.
- Magento Open Source or Adobe Commerce 2.4.7–2.4.9.
- PHP 8.2–8.5 with the intl and mbstring extensions.
- A supported theme and a search field in the store header. Hyvä requires Hyvä Theme 1.3+ with Hyva/default or a child theme.
- OpenSearch or Elasticsearch with healthy catalog, price, stock, and search indexes, plus Magento cron running.
What's included and where to configure it
Choose the Community, Enterprise, or Magento Cloud edition. The digital download is Smart Search — Version 1.4.1. Smart Search AI and AI Content are included.
Manage autocomplete, layouts, cart actions, pre-typing products, privacy, purchase history, relevance, and the AI assistant in Stores › Configuration › Techimprovement › Smart Search. Configure the AI provider and budget in Stores › Configuration › Techimprovement › AI Content.
Change Log
Version 1.4.1 – October 30, 2026
Fixed
- It was mounted by its data attribute already, so search works as before;
Earlier versions (4)
Version 1.4.0 – October 30, 2026
New
- Hyvä theme support: the suggestions panel works on the Hyvä header search (Hyvä Theme 1.3+, Hyva/default or a child theme, desktop and phone), with no change on Luma. hyva_default.xml loads smart-search.js deferred and the stylesheets at the end of the page from loader-hyva.phtml (no RequireJS, no inline script, nothing render-blocking), and marks the widget data-ass-theme="hyva". On Hyvä the widget moves next to the search form when the panel opens, so clicks in the suggestions no longer close Hyvä's search container, and the panel spans the whole search form (field and button). Hyvä's own query suggestions under the search field are hidden while Smart Search handles the field, and the search button is no longer disabled for short searches on Hyvä (the panel tells the shopper to type more).
- smart-search-hyva.css: plain CSS (no Tailwind classes, no Tailwind rebuild) that maps the panel colours to the Hyvä theme's colour variables; restyle with the --ass-* custom properties.
Improved
- Escape pressed inside the suggestions panel closes only the panel and returns focus to the search field (also on Luma, where the result is the same as before).
Fixed
- View all results is a real link (href to the search results page, ViewModel\Widget::getResultsUrl()); the script still updates it with the typed search. Lighthouse reported it as "links are not crawlable".
Version 1.3.3 – October 29, 2026
Fixed
- Suggestions in browsers without Element.replaceChildren (Chrome before 86, Safari before 14, Firefox before 78): typing showed no results, and every page load logged "TypeError: options.replaceChildren is not a function" (also in the Magepack storefront check of Zero Downtime Deployment, which runs in Chromium 80). The list is now emptied in a way every browser supports.
Version 1.3.2 – October 25, 2026
Improved
- Checkout: no "Search products" button is added when the checkout page has no store search field (for example a distraction-free checkout header). A search field in a checkout page that shows the store header still gets the suggestions. The widget block takes the argument search_launcher (false hides the button) for other pages.
Version 1.3.1 – October 24, 2026
New
- Event techimprovement_smart_search_price (product, store_id, transport with the price keys) after a shown price is formatted, so other modules can replace it; Techimprovement Free Products 1.1 shows "Free" for free products.
- Wide grid panel: with Desktop Product Layout set to Grid, the suggestions panel grows to Grid Panel Width (Pixels) (new setting, default 880, 560–1400), centred under the search field and kept inside the window. From 720 px it has a side column for the typo correction, recent searches, query suggestions and categories, and a main column with three or four product columns. Mobile grid uses the full screen width.
- Matching categories: up to Matching Categories (new setting, default 4, 0–8) active categories whose name contains every search word, with links.
- Searched words are highlighted in query suggestions and categories.
- View all results for "…" stays visible at the bottom of the panel and names the search.
- Try a search on the Search Intelligence dashboard: products in suggestion order with View and Edit links, categories, equivalent terms, typo correction and the search without stop words. Query rows open the preview.
- Extension point WidgetConfigProviderInterface for add-ons such as Smart Search AI.
Improved
- Panel colours follow the storefront's colour tokens, so the panel follows a dark colour scheme.
- A desktop grid panel is now wider than the search field. Set the width to 560 for a compact panel or use the List layout to keep the earlier width.
Reviews
Be the first to review Smart Search
Reviews are written by customers with an account. Sign in to tell others how it works on your store.
