Атрибуты товаров
Атрибуты товаров нужны для характеристик товара. Именно здесь компания заранее определяет, какие свойства можно будет заполнять в карточках товаров: материал, мощность, объем, состав, срок службы, совместимость и любые другие рабочие характеристики.
Этот справочник не описывает сами значения характеристик. Он описывает только типы атрибутов, которые потом используются в карточке товара.

Для кого и когда нужен этот документ
Этот документ нужен как основная инструкция по разделу Атрибуты товаров. Здесь собраны:
- назначение раздела
- описание карточки атрибута
- смысл полей Группа и В индексе
- связь с карточкой товара, поиском и фильтрацией
Открывайте этот документ, если нужно:
- создать новую характеристику для товаров
- понять, почему атрибут влияет на поиск
- привести к единому виду список характеристик компании
Релевантные разделы
- Товары: вкладка Атрибуты - если нужно посмотреть, где именно атрибуты заполняются.
- Товары: Обновить индекс - если изменения атрибутов не появились в поиске.
- Компонент Поиск - если важно, как индекс влияет на поиск клиента.
- Публикация каталога - если нужно понять роль атрибутов в витрине.
1. Для чего нужен этот раздел
Атрибут товара нужен, когда компания хочет хранить в карточке товара дополнительную характеристику.
Примеры атрибутов:
- Материал
- Мощность
- Объем
- Диаметр
- Страна производства
- Состав
Сам атрибут создается один раз в справочнике, а его значение заполняется уже в конкретной карточке товара.
2. Чем атрибут отличается от варианта товара
Это важное различие.
Атрибут:
- описывает характеристику товара
- не обязательно предполагает переключение между версиями товара
Вариант товара:
- описывает ту разницу, по которой покупатель должен переключаться внутри одной общей карточки
Например:
- Материал чаще всего обычный атрибут
- Цвет у вариантного товара чаще всего признак варианта
3. Как устроен интерфейс раздела
Раздел содержит список атрибутов, быстрый поиск и карточку записи.
Основные поля карточки:
- Наименование
- Группа
- В индексе

4. Что означают основные поля
Наименование
Это имя характеристики, которое будет видно сотруднику в карточке товара.
Группа
Группа помогает визуально объединять похожие характеристики.
Практический пример:
- группа Основные параметры
- группа Размеры
- группа Технические характеристики
В карточке товара это помогает сотруднику быстрее ориентироваться в длинном списке характеристик.
В индексе
Это одно из самых важных полей раздела.
Если атрибут находится В индексе, его проще использовать в поиске и фильтрации. Такие атрибуты полезны там, где компания хочет искать товары по этому признаку или выводить этот признак в фильтры.
Если атрибут неиндексируемый, он остается обычной характеристикой для карточки товара, но его роль в поиске и фильтрации слабее.
Практически это означает:
- атрибуты без признака В индексе не попадут в фильтры клиентских витрин, Telegram Mini App и Max мини-приложения
- такие атрибуты останутся обычными характеристиками товара, которые можно видеть в карточке, но не использовать как полноценный фильтр для покупателя
5. Где атрибуты используются дальше
5.1. В карточке товара
В карточке товара есть отдельная вкладка атрибутов. Там сотрудник выбирает атрибут из справочника и заполняет его значение.

5.2. В поиске и фильтрации
Если атрибут индексируется, компания может использовать его как более полезный признак для поиска и отбора товаров.
Это особенно важно для характеристик, по которым сотрудник или покупатель реально ищет товар.
5.3. В клиентских витринах
Атрибуты могут участвовать в данных товара, которые потом видны в клиентской витрине и карточке товара.
6. Когда стоит включать атрибут в индекс
Обычно атрибут стоит индексировать, если:
- по нему реально ищут товары
- он полезен для фильтров
- его значения достаточно структурированы и повторяемы
Обычно не стоит делать акцент на индексации, если:
- это редкая или слишком свободная текстовая заметка
- атрибут используется только как внутренний комментарий
7. Как поддерживать справочник в порядке
Чтобы список атрибутов оставался рабочим:
- не создавайте дубли с похожими названиями
- придерживайтесь единого стиля именования
- заранее продумайте группы
- не создавайте атрибут под один случайный товар, если признак не будет повторяться
Хороший справочник атрибутов делает карточки товаров чище и понятнее.