Настройка Shopify Metafields для кастомных полей

Представьте: вы добавили на товар характеристики — срок доставки, гарантию, вес нетто. Но в стандартной карточке 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

Типы *_reference и file_reference можно объявить списком (list.*) для хранения массива значений.

Как создать metafield definition через Admin?

Перейдите в Admin > Settings > Custom data. Выберите тип ресурса (например, Product), нажмите «Add definition». Задайте имя, namespace, key и тип данных. Определение фиксирует тип и делает поле видимым в карточках товаров в Admin. Без definition метаполе можно создать через API, но оно не отобразится в Admin UI и не будет доступно через Liquid (только через Storefront API).

1. Зайдите в панель администратора Shopify.
2. Перейдите в «Settings > Custom data».
3. Выберите тип ресурса (Product, Collection, Page и т.д.).
4. Нажмите «Add definition».
5. Заполните название, namespace, key и тип данных.
6. При необходимости настройте валидацию (например, min/max для чисел).
7. Сохраните определение.

Создание через 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.

{%- 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. Свяжитесь с нами, чтобы получить коммерческое предложение.