Метаданные для вариантов
Метаданные для вариантов нужны для товаров, которые остаются одним и тем же товаром по смыслу, но имеют несколько вариантов исполнения. Чаще всего речь идет о цвете, размере, длине, объеме и других похожих признаках.
Этот раздел помогает не создавать много почти одинаковых карточек товара, а собрать их в одну вариативную группу. Для покупателя это выглядит как один товар с выбором нужного варианта.

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


5. Быстрый поиск
Быстрый поиск помогает быстрее найти нужную запись, если справочник уже наполнен.
На практике поиск полезен, чтобы:
- проверить, не создан ли тип или вариант раньше
- быстро найти нужное значение среди большого списка
- не заводить дубли вроде Синий, blue и Blue
Перед созданием новых записей поиск лучше использовать всегда.
6. Как устроена работа с типами
Типы вариантов обычно создают нечасто. Это скорее каркас, на который потом опирается вся дальнейшая работа.
В реальной практике у компании таких типов обычно немного:
- цвет
- размер
- длина
- объем
- вкус
Если типов становится слишком много, сотрудникам становится сложнее ориентироваться, а карточки товаров заполняются менее аккуратно.
Некоторые типы могут уже быть доступны в системе заранее. Это нормально. В таком случае сотруднику остается использовать уже готовый тип, если он подходит под правила компании.
7. Как устроена карточка значения варианта
У каждого значения есть отдельная карточка.
Основные поля карточки:
- Тип
- Наименование
- Иконка
- Значение

Практический смысл полей:
- Тип показывает, к какому признаку относится запись
- Наименование используется как понятное имя для сотрудников и обычно для покупателя
- Значение хранит сам вариант в рабочем виде
- Иконка помогает визуально выделить вариант, если компания использует такой подход
8. Как правильно понимать поле Наименование
Наименование должно быть простым и однозначным.
Хорошие примеры:
- Белый
- Черный
- M
- 500 мл
Плохие примеры:
- слишком длинные описания
- разный стиль записи для одинаковых по смыслу значений
- смешение языков без общего правила
Именно это поле чаще всего видит сотрудник при выборе варианта в карточке товара.
9. Как правильно понимать поле Значение
Поле Значение хранит сам рабочий вариант в том формате, который принят в компании.
Для большинства типов это обычное значение:
- M
- 42
- 500 мл
- 150 см
Для цветового варианта это поле особенно важно. Если компания использует цветовые переключатели в клиентской витрине, сюда можно записывать значение цвета так, чтобы витрина корректно показывала сам цвет.
На практике важно не само название формата, а единое правило внутри компании. Если для цвета принят один способ записи, его стоит придерживаться по всему справочнику.
10. Где этот справочник используется дальше
10.1. В карточке товара
Именно здесь сотрудник связывает конкретный товар с нужным вариантом.
Если товар участвует в вариативной группе, без этого справочника невозможно аккуратно описать, чем именно один вариант отличается от другого.

10.2. В клиентской витрине, Telegram Mini App и Max мини-приложении
Если товар настроен как вариативный, покупатель видит одну общую карточку товара и может переключаться между вариантами.
Это особенно полезно для:
- одежды
- обуви
- товаров с цветами
- товаров с разным объемом или размером
11. Как поддерживать справочник в порядке
Чтобы раздел оставался удобным:
- не создавайте новый тип под каждый частный случай
- заранее договоритесь о названиях типов
- договоритесь, как будут называться значения внутри каждого типа
- не смешивайте несколько способов записи одного и того же значения
Хорошая практика:
- сначала утвердить небольшой набор типов
- затем уже наполнять их значениями
12. Что важно помнить при изменении и удалении
Если значение уже используется в товарах, менять его нужно аккуратно.
Практически это означает:
- не переименовывать рабочие значения без необходимости
- не создавать дубли с тем же смыслом
- перед удалением проверять, где запись уже используется
Особенно внимательным стоит быть с типом Цвет, если он уже выведен в клиентские витрины. Неаккуратные изменения там заметны не только сотрудникам, но и покупателям.