Налаштування Shopify Metafields для кастомних полів

Уявіть: ви додали до товару характеристики — термін доставки, гарантію, вагу нетто. Але в стандартній картці Shopify немає місця для цих даних. Без Metafields довелося б писати все в описі одним рядком, що ламає структуру. Ми стикалися з такою ситуацією десятки разів і знаємо, як вирішити її правильно. За нашими даними, правильно налаштовані метаполя скорочують час на оновлення каталогу на 40% і збільшують конверсію на 15–20% — це краще у 5 разів за стандартні описи. Середній чек зростає на 10%, а час адміністрування зменшується вдвічі. Ви заощаджуєте до 30% бюджету на підтримку каталогу. Вартість налаштування починається від 50 000 грн.

Metafields — вбудований механізм розширення стандартної моделі даних. Ви можете додати довільні поля для продуктів, варіантів, колекцій, клієнтів, замовлень, сторінок, блогів і самого магазину. Жодного кастомного додатка — лише конфігурація. Офіційна документація Shopify по Metafields радить використовувати namespace для групування.

Концепція 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 // Показувати вгорі в картці товару } } } }); 

Масове заповнення метаполів

// Встановлення метаполів для продукту 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-темі

{%- 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 } } } } } } `; 

alt: Налаштування Shopify Metafields для розробки ecommerce

Чому 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. Зв'яжіться з нами, щоб отримати комерційну пропозицію.