↑↓ selectEnter openEsc close

    1. Elbuz

    How to set up smart search results

    9 min readUpdated

    Elbuz lets you shape search results: your synonyms, out-of-stock products last or hidden — and you can check them on the “Search test” tab before installing the widget.

    When you need this:

    • Shoppers use their own words — a “Synonyms” line finds products with either word, no index rebuild.
    • Out-of-stock products get in the way — search hides them or puts them last.
    • You need to know what search finds before launch — “Search test” shows the same results.
    • You want the “Did you mean:” hint — paid AI spell check, turned on with a checkbox.

    Where to start: test your popular queries on the “Search test” tab.

    What you can set up in search results

    What you can turn on in the card and what it gives you

    FeatureWhat it gives you
    Fixing shoppers' mistakesalways on, with no switch and no charge: wrong keyboard layout (“ыфьыгтп” → Samsung), brands typed in Cyrillic (“асус” → ASUS), typos, everyday words and slang (“бп 750”, “винт 2 тб”, meaning a 750 W power supply and a 2 TB hard drive), models without spaces, a model number without a name (“5070”), a stuck key, other word forms — Ukrainian and Russian morphology are fully supported (“мишки”, “мишку” find “миша”, mouse). Details — how search understands mistakes. How it compares with another service — comparison with MultiSearch
    Check spelling of search queries using AIthe “Did you mean:” hint when built-in corrections didn't give a full match. Off until you turn it on; paid — see which settings are paid
    Synonymsyour own dictionary of matches in the word1;word2 format for words search doesn't understand on its own: terms specific to your niche, abbreviations, shopper slang
    Search by attributessearches by specifications and shows filters based on them
    Voice searchthe query is dictated into the microphone
    Show AI chatan AI assistant in the search window: it sees the query and offers help on its own — see AI assistant in the search window
    Show refinement hints (chips) above results using AIchips above the results: AI suggests ways to narrow the query. Off until you turn it on; paid — see which settings are paid
    Search in all languagesthe query is searched in all catalog languages, not just the current one; the product is shown in the storefront language even if the query words matched in another language
    In stock onlyout-of-stock products aren't shown at all
    In stock firstout-of-stock products aren't hidden but go to the end of the list

    “In stock first” works within the products already found and can change which one comes first. An example from the comparison with MultiSearch: for the query “iphone 16 pro 256”, iPhone 16 Pro Max comes first because it's in stock, and iPhone 16 Pro isn't.

    “In stock only” and “In stock first” are different strategies, and analytics shows which one to pick. If there are many queries but conversion is low, shoppers often run into “Out of stock”: the first option helps here. If your range is narrow, the second is better — otherwise search will look empty.

    What happens when several rules are on at once

    • “In stock only” and “In stock first” together. The first one wins: out-of-stock products are cut off before sorting, so the second rule changes nothing. “In stock” means a stock status marked as “in stock” in the status list; the list of these statuses is sent to the service when you save the widget card.
    • “In stock first” and the shopper's sorting. When a shopper sorts by price or another field, the rule stays on: the chosen sorting applies within the “in stock” and “out of stock” groups.
    • Synonyms. A word;replacement line doesn't replace the query, it expands it: products with the first word and with the second word are both found. You can use phrases of several words. A changed dictionary takes effect after you save the widget card, without rebuilding the index.
    • Synonyms and built-in corrections. Your synonyms take priority over the search dictionaries: if you've set your own meaning for a word, that one applies. Synonyms apply to every query, while keyboard layout and typo corrections kick in only when nothing was found for what was typed.
    • Built-in corrections and AI spell check. If AI spell check is on, it's requested in parallel for queries of three characters or more. A shopper usually sees the “Did you mean:” hint on a partial match — when neither the typed query nor built-in corrections helped. If nothing was found at all, the widget repeats the search with the AI suggestion and puts it in the search bar.
    Synonyms apply to every query; as long as something is found for what was typed, the shopper sees results for their own query; the AI correction goes into the search bar only at the very bottom
    yesnoyesnoyesnoyesnoyesnoShopper types a querySearch by what was typed, plussynonyms,brands in Cyrillic, everyday words,and models without spacesAnything found?Results for the shopper's queryWithout single characters,letters and digits separatelyFound?Other keyboard layout, thentypo correctionFound?Results for the corrected queryand a “Search instead for …” bannerSimilar words, then productswith at least one of the wordsFound?Partial match; if AI spell check is on—the “Did you mean:” hintDid AI suggest a correction?The AI suggestion goes into thesearch bar,search runs againNothing found
    • Action or result
    • Decision: the path depends on the answer

    How to test results without the widget on your site

    On the “Search test” tab of the widget card, you type a query and see the same results a shopper gets. You don't need to install the widget on your site for this, but search must be on and the index built; otherwise the tab shows “Search is off or the index is not built yet.”

    What each step means, why a query word may not be highlighted, and how to use this to find weak spots in your catalog — see How smart search understands shoppers' mistakes.

    Which search settings are paid

    Search itself is included in your Elbuz plan: the number of searches on your site isn't counted or charged. The features that call an AI model are paid — both are off until you turn them on on the “View” tab.

    Usage is measured in tokens, the amount of text sent to the model and received from it. Built-in corrections — keyboard layout, typos, brands in Cyrillic, everyday words, models without spaces — don't call AI during search and cost nothing.

    WhatWhen it spends
    Check spelling of search queries using AIoff until you turn it on in the widget card. Spends on every new query of three characters or more; a query already checked in the same language is taken from the saved result without calling the model. Queries made only of digits and punctuation aren't checked
    Refinement hintsoff until you turn it on in the widget card. Spends on a query that found something and hasn't had hints built in the same language yet; a query with no results gets no hints and spends nothing

    Site search costs are totaled by site and model and charged to your account balance as a separate line with a description like “LLM model: spell_check (count ops, thousands tokens)”. The charge doesn't check the balance: the amount is deducted even when the balance is already zero.

    Scenarios

    The switches below are in the smart search widget card.

    Shoppers type with mistakes and their own words, and search returns nothing

    What to do. In the “Smart Search Analytics” window, open the “Query Analysis” tab and write down queries with no results. Check each one on the “Search test” tab. Those that still give a red step but mean your product under another word — add them to the “Synonyms” field as word1;word2 lines and save the card.

    What you get. Search already handles wrong layout, typos, Cyrillic brands, and everyday category names — such queries show a green step on the test tab and need no synonym. For the rest, your dictionary applies: once saved, with no index rebuild, a query with the line's first word also searches for the second. The line doesn't work in reverse.

    What you won't get. A synonym doesn't replace the query, so products with the first word won't disappear from search. A product that isn't in the catalog won't be found under any spelling.

    Shoppers describe what they need the product for, and product names don't have those words

    What to do. Add lines to “Synonyms” that link shoppers' words to the words in product names: window washing;window cleaner. Test the query on the “Search test” tab.

    What you get. A query containing the phrase from the first part of the line also finds products with the word from the second part.

    What you won't get. Search doesn't do meaning-based search “by description” without matching words: the “AI training” and “Hybrid AI + Text Search” switches have been removed from the card, and vector search is off.

    You need to make sure search finds products before installing the widget on your site

    What to do. Turn on smart search, click “Create search index”, and open the “Search test” tab. Check the names of your popular products and the same queries with typos, in Cyrillic, and without spaces.

    What you get. The tab shows the same results as the widget on your site, along with the step that found them.

    What you won't get. The tab doesn't show how the widget looks on your site — use the “Open demo site” button for that.

    Out-of-stock products get in the way of finding what can be bought

    What to do. In a new widget both checkboxes are already on, and the first one applies. Wide range — keep “Search only for products that are in stock”. Narrow range — clear it and keep “Show in-stock products first (out-of-stock at the end of the list)”.

    What you get. The first switch removes out-of-stock products from the results. The second keeps them but places them after the ones in stock; the sorting a shopper picks applies within each of the two groups.

    What you won't get. Turned on together, the switches don't add up: out-of-stock products are cut off before sorting, and the second one changes nothing.

    What to do when search finds the wrong products

    What you seeWhyWhat to do
    It's unclear why a shopper's query found the wrong productssearch reached the result through a partial matchtest the query on the “Search test” tab and look at the step; if it's red, add a synonym or fix the product name
    The “Search test” tab shows “Found 0”, even though the product existsthe wrong storefront language is selected in the “Language” fieldselect the language your products are named in
    Search finds out-of-stock products“In stock only” is cleared, and only “In stock first” applieson the “Limits” tab, select “Search only for products that are in stock” if you don't need out-of-stock products at all

    FAQ

    Why use synonyms if search understands mistakes on its own?

    Search handles wrong keyboard layout, typos, brands in Cyrillic, and everyday category names on its own. Synonyms are for everything else: terms specific to your niche, abbreviations, words that appear neither in product names nor in category names. The format is simple: word1;word2.

    How do I stop search from showing out-of-stock products?

    On the “Limits” tab, select “Search only for products that are in stock” — in a new widget it's already selected. To keep out-of-stock products but move them down, clear it and keep “Show in-stock products first (out-of-stock at the end of the list)”.

    Why don't shoppers see the “Did you mean:” hint?

    AI spell check is off until you select the “Check spelling of search queries using AI” checkbox on the “View” tab. Even when it's on, the hint appears only when built-in corrections didn't give a full match.

    How do I show chips above the results?

    Select the “Show refinement hints (chips) above results using AI” checkbox on the “View” tab: it's cleared by default. Chips are built only for queries that found something, and they use tokens.

    Do I need to rebuild the index after changing synonyms?

    No. A changed synonym dictionary takes effect after you save the widget card.

    Where it is and who has access

    Menu
    Directories → Categories → the “Widget settings - Smart search” tile
    Access right
    the “Smart product search widget” window in “Group permissions”
    Prepare
    smart search turned on and a built search index

    Synonyms, voice search, search by attributes, and chat are on the “Settings” tab; stock options are on “Limits”; search in all languages and the AI checkboxes are on “View”; testing is on “Search test”.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free