В админке свойства товаров битрикс уже есть, а на сайте тишина: в умном фильтре нет бренда и цвета, в карточке пустой блок характеристик. Типичная ошибка - искать вину в "магии темы", хотя на практике ломаются тип свойства, галочка показа и фасетный индекс на 1С-Битрикс: Управление сайтом. Ниже пройдете цепочку: создали свойство в каталоге, заполнили значения, включили фильтр и вывод на витрине. После гайда откроете раздел и карточку тестового товара и проверите чек-лист.
Свойства товаров в CMS - это поля инфоблока каталога: бренд, материал, толщина, цвет вариации. Для фильтра берите Список (L) или Число (N), не свободную строку и не Файл. Галочки "Показывать в умном фильтре" и "Показывать на детальной" сами по себе мало что делают: нужны значения у товаров, пересоздание фасета и коды в параметрах catalog. Размер и цвет SKU держите в инфоблоке предложений, общие характеристики - у товара.
Речь только про интернет-магазин на CMS "1С-Битрикс: Управление сайтом" - свой сайт, инфоблок каталога, компоненты catalog.*. Это не Bitrix24: в поиске по "свойства товаров" часто всплывает CRM и helpdesk облака, а не вкладка свойств торгового каталога на сайте.
Ниже - end-to-end по характеристикам: от выбора типа поля до витрины, без ухода в полный UI карточки и без SEO/ЧПУ фильтра.
1. Когда нужны свойства товаров в CMS: фильтр, карточка, SKU и выгрузки
Свойство товара - характеристика, которую покупатель видит в фильтре раздела, в таблице на карточке или выбирает как вариант (цвет, размер). Без них каталог выглядит "голым": нельзя отфильтровать бренд, сравнить толщину, понять материал.
Делайте: разделите свойства на три корзины - общие для карточки и выгрузок (бренд, страна, материал), фильтруемые (бренд списком, толщина числом) и вариации SKU (цвет, размер). Для выбора оффера опирайтесь на торговые предложения (SKU), а не дублируйте "Цвет" на товаре и на предложении без нужды.
Не делайте: не ищите настройки витрины в уроках Bitrix24 CRM. На CMS всё живет в инфоблоке каталога и в параметрах компонентов магазина.
- Составьте список характеристик, которые покупатель реально использует.
- Отметьте, что должно быть в умном фильтре, а что только в карточке.
- Отдельно выпишите поля вариаций - они почти всегда в инфоблоке торговых предложений.
- Проверьте источник значений: вручную, обмен с 1С или прайс.
- Зафиксируйте символьные коды латиницей (BRAND, THICKNESS) - их потом пропишете в компонентах.
- В реальном проекте сразу решите, кто владеет справочником брендов: каталог или HL.
Схема:
Задача магазина → Тип свойства → Создание в инфоблоке → Заполнение у товаров → Умный фильтр / карточка → Чек-лист на витрине
2. Выберите тип свойства инфоблока под задачу
Тип свойства - "форма поля". От него зависит, удобно ли фильтровать и не разъедутся ли значения после импорта.
| Тип (код) | Когда брать | В умном фильтре |
|---|---|---|
| Список (L) | Бренд, материал - фиксированный набор | Да, лучший выбор для фасета |
| Число (N) | Толщина, вес, диаметр - диапазон "от-до" | Да, слайдер / min-max |
| Строка (S) | Артикул, произвольный текст | Плохо: строки размножаются |
| Файл (F) | PDF, сертификат, доп. файл | Нет (официально недоступно) |
| Привязка / HL | Единый справочник брендов | Да, если справочник аккуратный |
Делайте: для фильтра и обмена с 1С используйте Список с XML_ID у значений или привязку к справочнику. Числа - для диапазонов. Строку оставляйте для артикула.
Не делайте: не создавайте "бренд" строкой: например, после импорта получите "Nike", "nike" и "NIKE " как три пункта. Не ждите умного фильтра от типа Файл - опция для файла и видео недоступна. Часто ломается и фасет, если значения списка без XML_ID.
3. Создайте свойство в каталоге и заполните значения у товаров
Создать свойство можно через "Магазин → Свойства товаров" или "Контент → Инфоблоки → каталог → вкладка Свойства". Результат один: поле в инфоблоке с кодом CODE.
- Откройте инфоблок каталога и вкладку "Свойства" (или раздел магазина "Свойства товаров").
- Нажмите "Добавить": название, символьный код латиницей, сортировка SORT.
- Выберите тип: бренд - Список (L), толщина - Число (N), артикул - Строка (S).
- Для списка добавьте значения и сразу проставьте XML_ID.
- Сохраните. Откройте 2-3 тестовых товара в нужном разделе и заполните значения.
- Если свойство для вариаций - создавайте его в инфоблоке торговых предложений, не в товаре.
Делайте: сначала заполните тестовые позиции в одном разделе, потом массово.
Не делайте: не оставляйте CODE пустым или кириллицей - без кода свойство не попадёт в параметры компонента.
4. Включите умный фильтр и показ характеристик на витрине
Две разные галочки и два потребителя: фильтр раздела и карточка товара. Их часто путают.
Для умного фильтра:
- Включите "Показывать в умном фильтре" и выберите вид (чекбоксы, слайдер для числа).
- Если свойства привязаны к разделам - проверьте доступность в нужном разделе.
- При API-включении сначала убедитесь, что у инфоблока SECTION_PROPERTY=Y: иначе SMART_FILTER может молча не сохраниться.
- Пересоздайте фасетный индекс и сбросьте кеш.
- Откройте раздел: свойство должно появиться в
catalog.smart.filterс реальными значениями.
ЧПУ, SEO meta и AJAX фильтра - в отдельном материале: как настроить умный фильтр на Битрикс. Здесь задача одна: свойство попало в фасет.
Для карточки и списка:
- Включите "Показывать на детальной странице" (DETAIL_PAGE_SHOW).
- В параметрах catalog / catalog.element добавьте код в DETAIL_PROPERTY_CODE (или PROPERTY_CODE).
- В шаблоне характеристики берутся из
$arResult['DISPLAY_PROPERTIES']- пустой массив значит, код или флаг не дошли.
Шаблон element.php, галерея и кнопка "Купить" - в гайде по карточке товара. Здесь достаточно попадания в DISPLAY_PROPERTIES.
Делайте: проверяйте фильтр и карточку на одном тестовом товаре в одном разделе.
Не делайте: не ждите, что галочка умного фильтра сама выведет характеристику на детальной - это разные флаги.
5. Чек-лист: видно в карточке, участвует в фильтре, не ломает импорт и SKU
- Тип подходит задаче: L/N (или HL) для фильтра, S для артикула, F только для файлов.
- У тестовых товаров в разделе заполнены значения; в фильтре не нули.
- Фасет пересоздан после SMART_FILTER; кеш сброшен.
- На карточке код в DETAIL_PROPERTY_CODE / PROPERTY_CODE, DETAIL_PAGE_SHOW включен, DISPLAY_PROPERTIES не пуст.
- Вариации лежат в инфоблоке предложений; на товаре нет бессмысленных дублей "Цвет/Размер".
- У значений списка есть XML_ID; строковый бренд не размножается после обмена с 1С.
- В инкогнито проверены раздел с фильтром и детальная страница.
Делайте: держите чек-лист рядом с ТЗ на каталог. Одна пропущенная галочка = "в админке есть, на сайте нет".
Не делайте: не чините отсутствие фильтра правкой ЧПУ или шаблона карточки, пока не закрыты тип, SMART_FILTER и фасет. Пустой блок характеристик фасетом не лечится.
Что дальше
- Создайте 2-3 свойства (бренд списком, одно число, артикул строкой) и заполните тестовые товары.
- Включите нужные в умный фильтр, пересоздайте фасет, проверьте раздел.
- Добавьте коды в параметры карточки и убедитесь, что DISPLAY_PROPERTIES заполнен.
- Если нужны вариации цвета/размера - настройте SKU отдельно; если застряли на импорте или связке фильтр-карточка - напишите в контакты, разберём на вашем каталоге.
Автор: Максим Мольков, разработчик 1С-Битрикс.
Источники: официальная документация 1С-Битрикс - user help по свойствам инфоблока, курс "Интернет-магазин" (свойства товаров/SKU, умный фильтр, привязка к разделам), API CIBlockProperty::Add / Update; практика внедрений на CMS.
Частые вопросы
Как добавить свойство товара в Битрикс?
Откройте инфоблок каталога → вкладка "Свойства" (или "Магазин → Свойства товаров"), нажмите "Добавить", задайте название, латинский CODE и тип. Сохраните и заполните значение у 2-3 тестовых товаров в нужном разделе.
Почему свойство не видно в карточке товара?
Проверьте три слоя: значение заполнено у элемента, включен показ на детальной (DETAIL_PAGE_SHOW), код добавлен в DETAIL_PROPERTY_CODE / PROPERTY_CODE. В шаблоне смотрите DISPLAY_PROPERTIES - пустой массив значит, компонент не получил свойство.
Как сделать свойство для умного фильтра?
Выберите тип Список или Число (не Файл), включите "Показывать в умном фильтре", заполните значения у товаров раздела и пересоздайте фасетный индекс. Если галочка не сохраняется через API - проверьте SECTION_PROPERTY у инфоблока.
Чем свойство товара отличается от свойства торгового предложения?
Свойство товара описывает карточку целиком (бренд, материал). Свойство предложения (SKU) отличает варианты - цвет, размер. Вариации создавайте в инфоблоке торговых предложений, иначе фильтр и выбор оффера путаются.
Какой тип свойства выбрать для бренда?
Для фильтра и обмена с 1С берите Список (L) с XML_ID или справочник. Строка (S) быстро размножает "Nike / nike / NIKE" и ломает фасет. Артикул оставляйте строкой.
Свойство заполнено, галочка фильтра стоит, а в разделе пусто. Что проверить?
Убедитесь, что товары лежат в этом разделе, фасет пересоздан, кеш сброшен, а компонент фильтра смотрит на тот же инфоблок. Для файла и видео опция умного фильтра недоступна - смените тип.