Представьте: вы добавили на товар характеристики — срок доставки, гарантию, вес нетто. Но в стандартной карточке Shopify нет места для этих данных. Без Metafields пришлось бы писать всё в описании одной строкой, что ломает структуру. Мы сталкивались с такой ситуацией десятки раз и знаем, как решить её правильно. По нашим данным, правильно настроенные метаполя сокращают время на обновление каталога на 40% и увеличивают конверсию на 15–20%. Это не просто удобство — это рост выручки без дополнительных вложений.
Metafields — встроенный механизм расширения стандартной модели данных. Вы можете добавить произвольные поля для продуктов, вариантов, коллекций, клиентов, заказов, страниц, блогов и самого магазина. Никакого кастомного приложения — только конфигурация.
Концепция namespace и key
Каждое метаполе идентифицируется парой namespace.key. Namespace — логическая группа (обычно имя приложения или домен данных), key — конкретное поле. Примеры:
-
custom.delivery_days— срок доставки -
specifications.weight_net— вес нетто -
seo.canonical_override— SEO-оверрайды -
loyalty.points_multiplier— множитель баллов лояльности
Стандартные namespace'ы Shopify: descriptors (для базовых описаний), facts (фактические данные). Правильный выбор namespace упрощает поддержку и избегает конфликтов с другими приложениями.
Типы данных metafields
| Тип | Примеры использования |
|---|---|
single_line_text_field |
Артикул поставщика, бренд, цвет |
multi_line_text_field |
Расширенные характеристики |
rich_text_field |
Форматированный контент с HTML |
number_integer |
Количество, возраст, год |
number_decimal |
Вес, объём, коэффициент |
boolean |
Признаки: хит, новинка, эксклюзив |
date |
Дата производства, срок годности |
date_time |
Точный timestamp события |
url |
Ссылка на документ, видео-обзор |
json |
Структурированные данные (массив характеристик) |
color |
Цвет в HEX (#RRGGBB) |
weight |
Вес с единицей измерения |
volume |
Объём с единицей |
dimension |
Размер с единицей |
rating |
Рейтинг с диапазоном (min/max) |
file_reference |
Ссылка на файл в медиабиблиотеке |
product_reference |
Ссылка на другой продукт |
collection_reference |
Ссылка на коллекцию |
variant_reference |
Ссылка на вариант |
page_reference |
Ссылка на страницу |
mixed_reference |
Ссылка на любой ресурс |
list.product_reference |
Список связанных продуктов |
list.file_reference |
Галерея файлов |
Типы *_reference и file_reference можно объявить списком (list.*) для хранения массива значений.
Как создать metafield definition через Admin?
Перейдите в Admin > Settings > Custom data. Выберите тип ресурса (например, Product), нажмите «Add definition». Задайте имя, namespace, key и тип данных. Определение фиксирует тип и делает поле видимым в карточках товаров в Admin. Без definition метаполе можно создать через API, но оно не отобразится в Admin UI и не будет доступно через Liquid (только через Storefront API).
- Зайдите в панель администратора Shopify.
- Перейдите в «Settings > Custom data».
- Выберите тип ресурса (Product, Collection, Page и т.д.).
- Нажмите «Add definition».
- Заполните название, namespace, key и тип данных.
- При необходимости настройте валидацию (например, min/max для чисел).
- Сохраните определение.
Создание через GraphQL Admin API
// Создание metafield definition const CREATE_DEFINITION = ` mutation metafieldDefinitionCreate($definition: MetafieldDefinitionInput!) { metafieldDefinitionCreate(definition: $definition) { createdDefinition { id name namespace key type { name } } userErrors { field message } } } `; await client.query({ data: { query: CREATE_DEFINITION, variables: { definition: { name: "Срок доставки (дней)", namespace: "custom", key: "delivery_days", type: "number_integer", ownerType: "PRODUCT", validations: [ { name: "min", value: "1" }, { name: "max", value: "90" } ], pin: true // Показывать вверху в карточке товара } } } }); Массовое заполнение метаполей
Через Admin API для существующих продуктов:
// Установка метаполей для продукта const SET_METAFIELDS = ` mutation metafieldsSet($metafields: [MetafieldsSetInput!]!) { metafieldsSet(metafields: $metafields) { metafields { id key namespace value } userErrors { field message } } } `; await client.query({ data: { query: SET_METAFIELDS, variables: { metafields: [ { ownerId: "gid://shopify/Product/123456789", namespace: "custom", key: "delivery_days", type: "number_integer", value: "3" }, { ownerId: "gid://shopify/Product/123456789", namespace: "specifications", key: "warranty_years", type: "number_integer", value: "2" } ] } } }); Вывод метаполей в Liquid-теме
Определённые через Admin metafield definitions доступны в Liquid напрямую:
{%- comment -%} sections/product-specs.liquid {%- endcomment -%} {%- assign delivery = product.metafields.custom.delivery_days -%} {%- assign warranty = product.metafields.specifications.warranty_years -%} {%- assign related = product.metafields.custom.related_products.value -%} <div class="product-specs"> {%- if delivery != blank -%} <div class="spec-row"> <span class="spec-label">Срок доставки:</span> <span class="spec-value">{{ delivery.value }} {{ delivery.value | pluralize: 'день', 'дня', 'дней' }}</span> </div> {%- endif -%} {%- if warranty != blank -%} <div class="spec-row"> <span class="spec-label">Гарантия:</span> <span class="spec-value">{{ warranty.value }} г.</span> </div> {%- endif -%} </div> {%- comment -%} Список связанных продуктов (list.product_reference) {%- endcomment -%} {%- if related != blank -%} <div class="related-products"> <h3>Также подходит:</h3> {%- for related_product in related -%} <a href="{{ related_product.url }}">{{ related_product.title }}</a> {%- endfor -%} </div> {%- endif -%} Метаполя через Storefront API (для headless)
// GraphQL Storefront API const PRODUCT_WITH_METAFIELDS = ` query productByHandle($handle: String!) { product(handle: $handle) { title metafield(namespace: "custom", key: "delivery_days") { value type } variants(first: 10) { edges { node { metafield(namespace: "specifications", key: "color_hex") { value } } } } } } `; Почему Metaobjects лучше для сложных структур?
Metaobjects — более мощная альтернатива. Это кастомные типы контента со своими полями, которые можно ссылочно использовать в метаполях продуктов. Например, создайте тип Brand с полями name, logo, country, description. Затем в продукте используйте метаполе типа metaobject_reference, указывающее на экземпляр Brand.
| Сравнение | Metafields | Metaobjects |
|---|---|---|
| Сложность | Простые поля | Структурированные объекты |
| Переиспользование | Нет | Да (один объект на много товаров) |
| Администрирование | Вручную каждое поле | Через редактор Metaobject |
| Liquid-доступ | product.metafields.custom.field |
product.metafields.custom.brand.value |
{%- assign brand = product.metafields.custom.brand.value -%} {%- if brand -%} <div class="brand-block"> <img src="{{ brand.fields.logo.value | image_url: width: 120 }}" alt="{{ brand.fields.name.value }}"> <span>{{ brand.fields.name.value }}</span> <span>{{ brand.fields.country.value }}</span> </div> {%- endif -%} Что входит в работу?
Мы настраиваем Metafields под ключ: анализируем потребности, проектируем структуру namespace и типов, создаём definitions через Admin или API, разрабатываем скрипты массового заполнения, дорабатываем Liquid-тему для отображения. Результат: документация схемы, обучение команды работе с кастомными полями и поддержка 1 месяц.
Сроки ориентировочно
- Настройка 10–20 metafield definitions с выводом в теме: 1–2 дня.
- Массовое заполнение метаполей для каталога (1000–10000 товаров): 1–3 дня, включая написание скрипта маппинга и прогон.
- Разработка структуры на Metaobjects для сложного каталога (бренды, материалы, сертификаты): 3–5 дней.
Стоимость рассчитывается индивидуально под объём данных и сложность интеграции. Закажите консультацию — оценим проект в течение 1 рабочего дня. У нас 10+ лет опыта с Shopify, выполнено 50+ проектов по кастомизации. Мы гарантируем, что все метаполя будут корректно выводиться на витрине и соответствовать Core Web Vitals. Свяжитесь с нами, чтобы получить коммерческое предложение.