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
- Synonyms — your own dictionary for words search doesn't understand on its own.
- Stock — out-of-stock products are hidden or moved to the end of the list.
- Attributes, voice, and languages — search by specifications, voice search, search across all catalog languages.
- AI spell check and refinement hints — paid, off until you turn them on.
- Rule order — which rule wins when several are on.
- Results test — the same results a shopper sees, without the widget on your site.
What you can turn on in the card and what it gives you
| Feature | What it gives you |
|---|---|
| Fixing shoppers' mistakes | always 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 AI | the “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 |
| Synonyms | your 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 attributes | searches by specifications and shows filters based on them |
| Voice search | the query is dictated into the microphone |
| Show AI chat | an 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 AI | chips 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 languages | the 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 only | out-of-stock products aren't shown at all |
| In stock first | out-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;replacementline 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.
- 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.
| What | When it spends |
|---|---|
| Check spelling of search queries using AI | off 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 hints | off 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 see | Why | What to do |
|---|---|---|
| It's unclear why a shopper's query found the wrong products | search reached the result through a partial match | test 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 exists | the wrong storefront language is selected in the “Language” field | select the language your products are named in |
| Search finds out-of-stock products | “In stock only” is cleared, and only “In stock first” applies | on 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
- If you need the big picture — smart search on your website: what it does and where to start.
- If you need to know which mistakes search fixes on its own — how smart search understands shoppers' mistakes.
- If you're looking for queries to cover with synonyms — search analytics, the “Query Analysis” tab.
- If search shows old products after you change settings — how to update the search index.
- If you're choosing search for your site — what it gives your store.
