Smart search queries its own index, not your live database. Elbuz builds it from the catalog with one button; during a rebuild, shoppers search the previous copy.
When you need this:
- Site search finds nothing — “Create search index” builds the index.
- You updated the catalog from price lists or with an import template — a “Job schedule” job rebuilds the index.
- Search should cover only “Tires” or only the FAQ — “Product categories” and “Article sections” limit the index.
- You edit a product in its card or the grid — the change reaches search on save.
Where to start: click “Create search index” in the widget card.
What the search index does
- Full rebuild — products, categories, attributes, reviews, and articles with one button; meanwhile shoppers search the previous copy.
- Partial index — only selected product categories or article sections.
- Targeted update — editing a product in its card or in the base catalog grid reaches search without a rebuild.
- Scheduled rebuild — the “Indexing products for smart search” job picks up the “index outdated” flag.
- Protection against interruptions — if a rebuild breaks off while products are being written, shoppers aren't left with empty search.
How to build the search index
Until the index exists, search finds nothing: the service searches its own index, not your live database. The “Create search index” button builds it from scratch, and the checkboxes next to it decide what gets indexed:
- Products — the main part;
- Categories — so results include sections, not just products;
- Attributes — needed for attribute filters and for searching by attributes;
- Reviews — so search takes review text into account;
- Articles — search across your blog or help pages.
For a large catalog, a build takes tens of minutes; don't run it daily. Reindex after major changes: a bulk product upload, a new category structure, a new language. Base catalog grid edits (one or checked products) reach the index without a full rebuild; updates from price lists or an import template don't (see the table below).
What happens after you click “Create search index”
- First, Elbuz checks that smart search is on and that no other indexing is running. If search is off, “Smart search is off” appears next to the button; if indexing is already running (manual or scheduled), you see “Indexing is already running”. In both cases nothing is rebuilt.
- Products are written to a standby copy of the index. Shoppers keep searching the previous copy the whole time, and only once all products are written does search switch to the new copy; the old one is cleared.
- Categories, attributes, reviews, and articles are rebuilt differently: their table is cleared first, then refilled in place.
- At the end, the “index outdated” flag is cleared.
- Action or result
- Decision: the path depends on the answer
The sign that everything finished is the message next to the button: “Done at … · records: … · time …” — the finish time, the number of rows written, and the duration. There are more rows than products: each product is written separately for every active language, and categories, attributes, reviews, and articles are added to the total.
The message stays visible while the window is open. If you closed it, check the work log: while products are being written, “Indexing products for smart search” with a counter appears there every 5,000 rows, and after the products — “Indexing completed in …, total records …”.
A rebuild doesn't touch the widget settings: the synonym dictionary, URL templates, and button codes stay as they were.
How to index only part of the catalog or articles
Below the index checkboxes there are two buttons: “Product categories” and “Article sections”.
- “Product categories” opens the category tree: check, say, “Tires”, and only products from that category and all its subcategories go into the index. Nothing checked — the whole catalog is indexed.
- “Article sections” limits articles the same way — steps below.
- The selection applies from the next rebuild: after changing it, click “Create search index”, otherwise search keeps the products from the previous index.
- The “Limits” tab also has the “Product display limit” builder — rules on product fields. They also exclude products during an index rebuild, but to filter by category the “Product categories” button is simpler.
1
Index content checkboxes2
Product categories3
Article sections- Index content checkboxes — what goes into the search: products, categories, attributes, reviews, articles.
- Product categories — index only the checked categories with subcategories; empty means the whole catalog.
- Article sections — the same for articles.
Index only the article sections you need (for example, the FAQ)
By default, with the “Articles” checkbox on, all articles go into the index. To have smart search index only certain sections — say, just the FAQ without the blog and news — click “Article sections” next to “Create search index” in the widget card. The “Select article sections” window opens with the section tree:
- Check the sections you need. A section includes all its nested subsections and articles — you don't need to check each article.
- Click “Save”. The “Article sections” button in the widget card shows the number of checked sections in parentheses.
- Rebuild the index with “Create search index” with the “Articles” checkbox on. The limit applies during the rebuild; until then, search shows articles from the previous index.
1
Save button2
Section tree with checkboxes3
Hint at the bottom- Save — applies the chosen sections to the widget's index scope.
- Section tree with checkboxes — a checked section covers everything nested in it.
- Hint — nothing checked means no limit.
If nothing is checked, there's no limit and all articles are indexed. To clear all checks at once, use “Clear all” in the “Additional operations” menu (the three-line button) of the same window.
When catalog changes reach search
| What you did | What happens to search |
|---|---|
| Saved a product card or changed one product field (other than an attribute value) in the base catalog grid | the product's index entry is deleted and rewritten when you save. If the product is disabled or excluded from export, it isn't rewritten — and disappears from search |
| Applied a change to checked products in the grid (“Set value in bulk”, other than an attribute value) or changed their category (“Change product category”) | same as for one product: the entries of all checked products are deleted and rewritten; disabled products or those excluded from export disappear from search |
| Deleted a product from the base catalog | its entry is removed from the index when it's deleted |
| Updated the base catalog from all price lists at once or loaded data with an import template | the index is only flagged as outdated; products are updated, removed, or added in search after the next full rebuild |
| Changed, disabled, or deleted a category or an article | same: the “index outdated” flag, and the change itself shows up after a full rebuild. Products of a disabled category also disappear from search only after it |
The “index outdated” flag doesn't act on its own: the “Indexing products for smart search” job in the “Job schedule” window picks it up, or you click “Create search index”. Without either, search shows the catalog as of the last rebuild. While it's set, targeted updates from the card or grid are skipped until the rebuild.
Scenarios
The base catalog is updated from all price lists at once or with an import template, and search must keep up
What to do. In the “Job schedule” window, turn on the job that indexes products for smart search.
What you get. A bulk update sets the “index outdated” flag. When the job sees it, it rebuilds the index in full: products are written to the standby copy, and shoppers search the previous one until the rebuild ends.
What won't happen. Without the flag, the scheduled job rebuilds nothing. While the flag is set, saving a product card doesn't reach search separately — the change arrives with the rebuild.
Search should cover only one category, for example “Tires”
What to do. On the “Settings” tab, below the index checkboxes, click “Product categories”, check the category, and click “Create search index”.
What you get. The index keeps products of that category and its subcategories; products from other categories don't get into search.
What won't happen. Until the rebuild, search shows products from the previous index.
Site search should find only the FAQ, without the blog and news
What to do. Click “Article sections”, check the FAQ section, click “Save”, and rebuild the index with the “Articles” checkbox on.
What you get. Only articles from the FAQ section and its nested subsections go into the index.
What won't happen. If nothing is checked, there's no limit and all articles are indexed.
What to do when search doesn't see catalog changes
| What you see | Why | What to do |
|---|---|---|
| Search finds nothing | the index hasn't been built | click “Create search index” |
| New products are missing from search | the index doesn't update instantly | reindex after bulk catalog changes |
| Attribute filters are empty | attributes weren't checked when the index was built | reindex with the “Attributes” checkbox on |
If a rebuild is interrupted
- The connection dropped. “No response from the server” appears next to the button. That's not a failure yet: indexing may have kept running on the server; check the work log for the result.
- Break-off while products are being written. Search stays on the previous copy of the index, so shoppers see the catalog as of the last rebuild, not an empty result.
- Break-off during categories, attributes, reviews, or articles. Their table had already been cleared, so until the next full rebuild search will have fewer of these entries or none at all.
- Restart. If the “index outdated” flag was set, it's cleared only at the end of a successful run, so the scheduled job starts the rebuild again as soon as the “indexing in progress” flag is cleared. There won't be duplicates: each table is cleared before writing.
- The process crashed, but the button says “Indexing is already running”. The “indexing in progress” flag clears itself if the run has shown no progress for more than 30 minutes; after that you can start it again.
FAQ
How often should I reindex the catalog?
Run a full rebuild after major changes: a bulk product upload, restructured categories, a new language. For a large catalog it takes tens of minutes, so there's no need to run it daily.
I updated products — how do I update search on my site?
Edits in a product card or to checked products in the base catalog grid reach search on their own. After an update from price lists or with an import template, click “Create search index” or add a job to the “Job schedule”. More: when changes reach search.
Does the “AI product index” tile update site search?
No. That's a different index, used by the catalog's AI features: product matching and AI matching. Site search is updated only by the “Create search index” button in the smart search widget card or by a job in the “Job schedule”.
Why does it say “Indexing is already running” next to the button?
Indexing has already been started, manually or on schedule. If the process crashed, the flag clears itself when there's been no progress for more than 30 minutes. More: if a rebuild is interrupted.
Will a rebuild erase synonyms and widget settings?
No. The synonym dictionary, URL templates, and button codes stay as they were after a rebuild.
Where to find it and who has access
- Menu
- Directories → Categories → the “Widget settings - Smart search” tile, “Settings” tab
- Other entry points
- “Job schedule” → the “Indexing products for smart search” job
- Access right
- the “Smart product search widget” window in “Group permissions”
- Prepare
- smart search turned on in the widget card
Related topics
- If you need the big picture — smart search on your website: what it does and where to start.
- If the index is built but the results are wrong — how to set up smart search results.
- If a new brand is found when typed in Latin letters but not in Cyrillic — when new brands start being recognized.
