When Bitrix built-in search stops working
With 100 thousand products, the built-in MySQL-based search slows down: queries to b_search_content take 300–500 ms, and on a million-record database — timeout. Clients complain about long search times, price sorting doesn't work, facets overload the database. For example, a recent project with a catalog of 250,000 products: standard search returned results in 2–3 seconds, complex property filters (price, brand, size) caused 30-second pauses. Elasticsearch solves this radically: response time 5–30 ms, aggregations on the fly, typos and morphology out of the box. Our experience — 30+ ES integrations with Bitrix, we guarantee a turnkey result. We use licensed components and are 1C-Bitrix certified. To understand if Elasticsearch is right for your project, order a free audit — we will analyze the load and data structure.
Problems that Elasticsearch solves
Elasticsearch replaces the standard Bitrix search engine and solves three key problems:
- Full-text search speed. MySQL FULLTEXT starts slowing down at 50–100 thousand documents. ES handles millions.
- Faceted search (aggregations). Bitrix built-in filters are separate queries for each property. ES returns aggregations in one request, giving a 10–20x gain on complex filters.
- Search with typos and synonyms. Without third-party modules, MySQL does not support fuzzy search. ES has built-in fuzziness and synonyms.
If you face similar issues, contact us for an audit — it will help identify bottlenecks.
Why Elasticsearch is faster than MySQL FULLTEXT?
| Characteristic | MySQL FULLTEXT | Elasticsearch |
|---|---|---|
| Index type | B-tree + inverted file | Inverted index + FST |
| Morphology | External dictionaries needed (morphy) | Stemmer and analyzers (russian) |
| Typo search | Not supported | Fuzziness (AUTO) |
| Aggregations (facets) | Not supported | Supported, in one query |
| Speed on 1 million documents (single query) | 200–500 ms | 5–30 ms |
Elasticsearch is 10–50 times faster than MySQL FULLTEXT on large data.
Integration architecture
The integration consists of three parts:
- Indexer — a component that reads data from Bitrix (infoblocks, users, pages) and writes documents to Elasticsearch index.
- Search gateway — replaces standard requests to b_search_content with requests to Elasticsearch API. The gateway is implemented as a PHP proxy: it receives a request from the standard
bitrix:search.pagecomponent, transforms it into Elasticsearch query DSL, and returns results in the format expected by Bitrix. - Event handlers — update the index when entities are modified or deleted.
Index structure for product catalog
The index is created via Elasticsearch Mapping API. Example mapping for products:
PUT /bitrix_catalog { "mappings": { "properties": { "id": { "type": "integer" }, "iblock_id": { "type": "integer" }, "name": { "type": "text", "analyzer": "russian" }, "description": { "type": "text", "analyzer": "russian" }, "sku": { "type": "keyword" }, "price": { "type": "float" }, "active": { "type": "boolean" }, "section_id": { "type": "integer" }, "properties": { "type": "object" }, "updated_at": { "type": "date" } } }, "settings": { "analysis": { "analyzer": { "russian": { "type": "custom", "tokenizer": "standard", "filter": ["lowercase", "russian_stop", "russian_stemmer"] } }, "filter": { "russian_stemmer": { "type": "stemmer", "language": "russian" }, "russian_stop": { "type": "stop", "stopwords": "_russian_" } } } } } The russian analyzer with stemmer is a key difference from MySQL FULLTEXT, which without additional dictionaries does not understand morphology.
Example analyzer configuration with synonyms
PUT /bitrix_catalog/_settings { "analysis": { "filter": { "russian_synonyms": { "type": "synonym", "synonyms": [ "брюки, штаны, джинсы => trousers", "смартфон, телефон, мобила => mobile" ] } }, "analyzer": { "russian_with_synonyms": { "tokenizer": "standard", "filter": ["lowercase", "russian_stop", "russian_stemmer", "russian_synonyms"] } } } } How to set up automatic index update?
Subscribe to infoblock events:
// local/php_interface/init.php AddEventHandler('iblock', 'OnAfterIBlockElementUpdate', 'esUpdateProduct'); AddEventHandler('iblock', 'OnAfterIBlockElementDelete', 'esDeleteProduct'); function esUpdateProduct(array &$arFields): void { $client = getEsClient(); $productId = (int)$arFields['ID']; // Re-index a single document $client->index([ 'index' => 'bitrix_catalog', 'id' => $productId, 'body' => buildProductDocument($productId), ]); } function esDeleteProduct(int $productId): void { getEsClient()->delete(['index' => 'bitrix_catalog', 'id' => $productId]); } The OnAfterIBlockElementUpdate event also triggers on API changes (1C import), which is important for index freshness.
Data indexing
Initial indexing is run via a cron script. Data is read in batches using CIBlockElement::GetList() with nTopCount = 100 and offset to avoid memory overload:
\Bitrix\Main\Loader::includeModule('iblock'); $client = \Elasticsearch\ClientBuilder::create() ->setHosts(['localhost:9200']) ->build(); $offset = 0; $batchSize = 100; do { $res = \CIBlockElement::GetList( [], ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'], false, ['nTopCount' => $batchSize, 'nPageSize' => $batchSize, 'iNumPage' => floor($offset / $batchSize) + 1], ['ID', 'NAME', 'DETAIL_TEXT', 'IBLOCK_ID', 'IBLOCK_SECTION_ID'] ); $bulk = []; while ($item = $res->GetNext()) { $bulk[] = ['index' => ['_index' => 'bitrix_catalog', '_id' => $item['ID']]]; $bulk[] = [ 'id' => (int)$item['ID'], 'iblock_id' => (int)$item['IBLOCK_ID'], 'name' => $item['NAME'], 'description'=> strip_tags($item['DETAIL_TEXT']), 'section_id' => (int)$item['IBLOCK_SECTION_ID'], 'active' => true, 'updated_at' => date('c'), ]; $offset++; } if (!empty($bulk)) { $client->bulk(['body' => $bulk]); } } while ($res->SelectedRowsCount() === $batchSize); Bulk API allows sending up to 1000 documents per request. Do not use individual index requests for initial indexing — it is 10–50 times slower.
Search query
Replace the standard bitrix:search.page component with a custom one that queries Elasticsearch:
$response = $client->search([ 'index' => 'bitrix_catalog', 'body' => [ 'query' => [ 'multi_match' => [ 'query' => $searchQuery, 'fields' => ['name^3', 'description', 'sku'], 'type' => 'best_fields', 'fuzziness' => 'AUTO', ], ], 'sort' => ['_score' => ['order' => 'desc']], 'from' => ($page - 1) * $pageSize, 'size' => $pageSize, ], ]); The fuzziness: AUTO parameter provides typo search: for words up to 5 characters, 1 substitution is allowed; for longer words, 2 substitutions.
What is included in our work?
- Audit of current search and load.
- Setting up Elasticsearch cluster (version, configuration, monitoring).
- Creating mapping according to your data structure.
- Developing indexer and search gateway.
- Configuring events for automatic update.
- Performance and accuracy testing.
- Documentation and training for your team.
- Support during the warranty period.
- Monitoring and alerts for indexing failures.
Implementation timeline
| Scope | Components | Duration |
|---|---|---|
| Basic | ES installation, mapping, indexer, search gateway | 5–7 days |
| Full | Faceted search via aggregations, suggestions (suggest), synonyms, autocomplete | 10–14 days |
Contact us for a consultation. Get an accurate project estimate and architectural recommendations — with no obligation.

