Как создать Highload-блок на 1С-Битрикс: справочники, свойства и вывод на сайте

Бренды и города в свойствах инфоблока раздули каталог - фильтр тормозит, заказчик просит "вынести справочник". Highload-блок (HL) в 1С-Битрикс: Управление сайтом - отдельная плоская таблица MySQL с полями UF_* и формой в админке, а не "инфоблок, только быстрее". Ниже - когда HL уместен, создание в админке, вывод через bitrix:highloadblock.list и D7 ORM, индексы на UF_* и типовые ошибки. Проверено 30 июля 2026.

Highload-блок (HL) в 1С-Битрикс: Управление сайтом - отдельная плоская таблица MySQL со своими UF_-полями и формой в админке "Контент → Highload-блоки". Без иерархии разделов и SEO-страниц элементов; для больших справочников (бренды, города, коды), связи с каталогом через UF_XML_ID и быстрой выборки через D7 ORM compileEntity и getList. Сегодня: создайте блок, заполните справочник, выведите list/view или getList, добавьте ADD INDEX на поля фильтра.

Bitrix24 - CRM в облаке, не наш продукт. Здесь только коробочная CMS на вашем сервере. Углублённый add/update/delete - в гайде по D7 CRUD для Highload; обзор кластера - в хабе по Highload-блокам. В выдаче много сниппетов с HL=1 и мало связки "админка → компонент → индексы".

Оцените, когда Highload оправдан вместо инфоблока

Инфоблок - контент с разделами, SEO и карточкой элемента. HL - плоский справочник: бренды, города, коды складов, логи. Без иерархии и без URL элемента на сайте.

Если умный фильтр на Битрикс тормозит из-за "списка" с тысячами значений - кандидат на HL.

Когда HL: справочники от 3-5 тысяч строк, логи без SEO. Когда НЕ нужен HL: контент с разделами и ЧПУ, новости с мета-тегами, товары с карточкой и галереей, любая иерархия "раздел → элемент". Для этого создайте инфоблок в админке - HL не заменит SEO и дерево разделов.

Делайте: выносите только "тяжёлые" справочники. Не делайте: не дублируйте товары в HL "ради скорости".

Создайте HL-блок в админке CMS

Путь: Контент → Highload-блоки → Добавить. Поля HL - пользовательские поля с объектом HLBLOCK_ID.

1. Название сущности латиницей: BrandDirectory.
2. TABLE_NAME в snake_case: b_hlbd_brands - уникально в базе.
3. Языковые названия для редакторов в админке.
4. Права на закладке "Права" (с 17.0.0 модуля).
5. ID блока после сохранения - для BLOCK_ID и кода. Не копируйте HL=1 с Habr.

Добавьте UF_NAME, UF_XML_ID, UF_SORT, UF_ACTIVE; для логотипа - UF_FILE. В каталоге задайте тип свойства "Справочник" с привязкой к HL - штатный путь из курса CMS (COURSE_ID=41).

Делайте: фиксируйте ID и TABLE_NAME в документации. Не делайте: не меняйте TABLE_NAME на проде без миграции.

Заполните справочник и свяжите с каталогом

Записи: "Контент → Highload-блоки → [блок] → Элементы". Тысячи строк - импорт CSV или штатный экспорт/импорт модуля.

Связка: HL (UF_XML_ID) → свойство "Справочник" в товаре → фильтр по коду → без раздувания свойств IB

С 1С синхронизируйте UF_XML_ID - см. интеграцию 1С с сайтом. В товаре храните XML_ID, не текст бренда.

Делайте: проверьте уникальность UF_XML_ID перед импортом. Не делайте: не заливайте 50 000 строк без теста на стенде.

Выведите справочник компонентами list и view

В модуле highloadblock есть bitrix:highloadblock.list и bitrix:highloadblock.view. В визредакторе: "Контент → Highload инфоблоки" или ручная вставка.

List - таблица записей на странице "Все бренды". Параметры: BLOCK_ID (ID из админки), DETAIL_URL (шаблон /brands/#ID#/), ROWS_PER_PAGE, SORT_FIELD, SORT_ORDER. View - одна запис по ROW_ID из URL; укажите BLOCK_ID и шаблон DETAIL_URL в list, чтобы ссылки вели на view-страницу.

<?php
$APPLICATION->IncludeComponent(
 'bitrix:highloadblock.list',
 '',
 [
 'BLOCK_ID' => BRAND_HL_ID,
 'DETAIL_URL' => '/brands/#ID#/',
 'ROWS_PER_PAGE' => 50,
 'SORT_FIELD' => 'UF_SORT',
 'SORT_ORDER' => 'ASC',
 ]
);

Делайте: для типового списка брендов начните с list и кастомизируйте шаблон. Не делайте: не пишите compileEntity, если штатный компонент закрывает задачу.

Прочитайте данные через compileEntity и getList

D7 ORM: Loader::includeModule('highloadblock') → getById → compileEntity → getDataClass → getList. Классы HighloadBlockTable, compileEntity и getDataClass - канон api_d7.

<?php
use Bitrix\Main\Loader;
use Bitrix\Highloadblock\HighloadBlockTable;

Loader::includeModule('highloadblock');
$hlblock = HighloadBlockTable::getById(BRAND_HL_ID)->fetch();
if (!$hlblock) return;
$entity = HighloadBlockTable::compileEntity($hlblock);
$dataClass = $entity->getDataClass();
$rows = $dataClass::getList([
 'select' => ['ID', 'UF_NAME', 'UF_XML_ID'],
 'filter' => ['=UF_ACTIVE' => 1],
 'order' => ['UF_SORT' => 'ASC'],
 'limit' => 50,
])->fetchAll();

Битый ID даёт Invalid highloadblock description - типичная ошибка на практике: getById(1) с Habr, на проде блок с ID=4. Кэшируйте $dataClass в static или Bitrix\Main\Data\Cache с TTL 3600, не compileEntity на каждый hit каталога.

Для вывода в шаблоне интернет-магазина getList удобен, когда нужна кастомная верстка списка брендов вне стандартного шаблона list. add/update/delete, AddResult и кэш entity - в гайде по Highload D7 CRUD - здесь только чтение, без дубля полного справочника операций.

Делайте: getById()->fetch() перед compileEntity. Не делайте: не наследуйте DataClass без getEntity - Unknown field definition.

Создайте HL через API для миграций

На staging: HighloadBlockTable::add с полями NAME и TABLE_NAME, затем UF_-поля через CUserTypeEntity. Удобно для Sprint Migration и install-скриптов модуля - TABLE_NAME и набор UF_* совпадают на dev и prod. На проде для разовой задачи быстрее админка.

Делайте: фиксируйте структуру HL в миграции. Не делайте: не вызывайте highloadblock до загрузки обработчика пользовательских полей в init.php - типичный bootstrap-конфликт из api_help.

Проверьте индексы UF_* и производительность

После 5-10k строк без индекса - full scan. Битрикс не ставит индексы на UF_* сам:

ALTER TABLE b_hlbd_brands ADD INDEX ix_xml_id (UF_XML_ID);
ALTER TABLE b_hlbd_brands ADD INDEX ix_name (UF_NAME);

После ADD INDEX - EXPLAIN: type ref/range, не ALL.

Делайте: после выноса справочника прогоните фильтр под нагрузкой - в результате получите предсказуемое время ответа. Не делайте: не считайте HL ускорителем без индексов - это обычная MySQL-таблица с формой в админке.

Обзор кластера "highload блоки битрикс" - в хабе по Highload на CMS. Заложите поддержку сайта на мониторинг медленных запросов после выноса справочника.

Аудит каталога и вынос справочников - обсудим задачу. Кейсы - в портфолио.

Автор: Максим Мольков, разработчик 1С-Битрикс.
Источники: dev.1c-bitrix.ru, api_d7 highloadblock. Проверка: 30 июля 2026.

Частые вопросы