Характеристики <param>

<param> — произвольные атрибуты товара: Цвет, Размер, Материал, Стиль и т. д. Это основной материал для фильтров (фасетов) и дополнительный сигнал для поиска. Состав характеристик у каждого магазина свой — сервис обнаруживает их автоматически.

Синтаксис

<param name="Цвет" type="color">белый</param>
<param name="Размер">XS</param>

Часть	Обяз.	Назначение
атрибут name	✅	Имя характеристики. По нему характеристики группируются между товарами. param без name пропускается.
атрибут type	—	Подсказка типа (учитывается color / enum / string).
атрибут picture	—	Вид в фильтре: адрес картинки-образца или код цвета, который фильтр показывает рядом с названием. Имя атрибута настраивается.
текст элемента	✅	Значение. Пустое значение пропускается.

Имена должны быть стабильны

Имя характеристики — это ключ. Цвет и цвет — разные характеристики. Держите написание постоянным между выгрузками, иначе появятся дубли фильтров.

Многозначные характеристики

Одна характеристика может встречаться в оффере несколько раз — тогда значения собираются в список:

<param name="Случай">на каждый день</param>
<param name="Случай">на день рождения</param>

Повтор имени внутри одного оффера сервис распознаёт автоматически.

Значения через разделитель (split)

Иногда несколько значений упакованы в одну строку через запятую:

<param name="Стиль">вечерние, деловые, повседневные</param>

Такой тег по умолчанию хранится как одна строка. Чтобы разбить его на список, в карточке проекта у характеристики в колонке «Многозначность» выберите «Множественное через разделитель». По умолчанию разделитель — запятая; сменить символ и обрезку пробелов можно по кнопке «Разделитель» в строке характеристики.

Вид в фильтре: картинка или цвет рядом со значением

У значения фильтра может быть свой вид — маленькая картинка (образец цвета, ткани, принта) или код цвета. Фильтр показывает его рядом с названием значения:

<param name="Цвет" picture="https://example.com/swatch/multicam.webp">Мультикам</param>
<param name="Цвет" picture="#f5f0e6">Айвори</param>

Поддержана и старая форма — соседняя характеристика с картинкой (Цвет + Картинка цвета), её переписывать не обязательно.

Правила, требования к размеру картинки, настройка в личном кабинете и проверка результата — на отдельной странице «Вид значений в фильтре».

Типы характеристик

Тип	Когда использовать
string	Текстовые значения по умолчанию.
enum	Ограниченный перечень (стиль, сезон).
color	Цвет — значение показывается образцом цвета в фильтре.
number / float	Числовые значения.
boolean	Да/нет.

В выпадающем списке типов есть ещё служебные array и object — для сложных структур; в обычных каталогах они не нужны.

Настройка в личном кабинете

В карточке проекта для каждой характеристики можно задать:

Настройка	Что даёт
Тип	Тип значения (см. выше).
Многозначность	«Одно значение», «Множественное» (список; повтор тега распознаётся автоматически) или «Множественное через разделитель» (строка режется на список, разделитель настраивается кнопкой «Разделитель»).
В поиске	Значения участвуют в поиске. Русские слова находятся в любой форме и в любом регистре: «креветок» и «креветка» найдут «КРЕВЕТКИ тигровые».
Поиск по подстроке	Находить по части слова (инфикс); при желании включается и префиксный поиск.
Вес в поиске	Насколько сильно совпадение по этой характеристике влияет на ранжирование.
Фильтр (фасет)	Доступна как фильтр в витрине.
Сортировка	По ней можно сортировать выдачу.
Отображение	Показывать в карточке результата.
Агрегировать в группах	При группировке SKU объединять значения вариантов.
Вид в фильтре	Откуда брать картинку-образец или код цвета для значений этого фильтра — подробнее.

Порядок, в котором фильтры идут в витрине, задаётся кнопкой «Порядок фильтров» над таблицей — он общий для полей и характеристик.

Не всё стоит делать фильтром

Фильтрами имеет смысл делать характеристики с ограниченным набором значений (Цвет, Размер, Материал, Стиль). Уникальные для каждого товара значения (например, Картинка цвета с URL) в фильтры выносить не нужно — такая характеристика задаёт вид значений другого фильтра, а не становится фильтром сама.

Пример набора характеристик

Обезличенный пример из фида магазина одежды — 16 характеристик и число вхождений:

Характеристика	Вхождений	Пример значений	Обычно
Случай	8338	на каждый день, на выпускной, в ресторан	многозначная
Стиль	4960	вечерние, деловые, повседневные	многозначная
Застежки	4049	молния, пуговицы, шнуровка	многозначная
Материал	3578	хлопок, лен, бархат, кружево	многозначная
Цвет	2826	белый, бежевый, бордо	фильтр с образцами цвета
Фасон	2664	—	фильтр
Узор	2454	однотонный, полоска, клетка	фильтр
Размер	2425	XS, S, M, L, ONE SIZE	фильтр / вариант
Предзаказ	2425	Да, Нет	фильтр
Картинка цвета	2421	URL картинки	вид значений фильтра Цвет
Силуэт	2212	приталенный, свободный, оверсайз	фильтр
Рукав	1907	длинный, короткий, без рукава	фильтр
Длина	1718	макси, миди, мини	фильтр
Детали	1398	—	фильтр
Воротник	371	—	фильтр
Limited	164	—	метка