Определение Metafield

Metafields позволяют хранить пользовательские данные для продуктов, заказов, клиентов и других ресурсов в Shopify. Они полезны для добавления дополнительной информации, такой как руководства по размерам, спецификации, данные SEO или внутренние заметки.

Узнайте больше о metafields в Shopify →

С помощью DataEase вы можете импортировать, экспортировать и обновлять metafields легко, используя динамические столбцы в ваших файлах.

📊 Как работают Metafields в DataEase

Когда вы экспортируете данные из DataEase, metafields отображаются как динамические столбцы. Это означает, что каждый metafield получает свой собственный столбец в файле, используя определенный формат именования:

metafield {namespace}.{name} [{type}]

Пример:

metafield global.description_tag [single_line_text_field]

Эта структура указывает DataEase (и Shopify), к какому metafield вы обращаетесь и в каком формате.

🧠 Логика импорта Metafield

Если metafield отсутствует в вашем файле импорта, он не будет изменен.
Если metafield присутствует в файле, но пуст, он будет удален из Shopify.
Если metafield имеет значение, он будет создан или обновлен.

Это упрощает управление metafields без перезаписи данных, которые вы не хотите изменять.

🧩 Поддерживаемые типы Metafield

Shopify поддерживает широкий спектр типов metafield. Вы можете увидеть полный список здесь:

Используйте эти типы в заголовках столбцов при импорте. Например:

metafield specs.material [multi_line_text_field]
metafield shipping.weight [number_decimal]

📏 Ограничения Metafield

Перед работой с metafields, обратите внимание на ограничения Shopify:

🔢 Ограничения на ресурс

250 определений на тип ресурса
20 закрепленных определений на тип ресурса

📦 Ограничения по символам в зависимости от типа

Тип	Ограничение по символам
boolean	65,000
color	65,000
date	65,000
date_time	65,000
dimension	65,000
id	2,048
json	2,000,000
link	65,000
money	65,000
multi_line_text_field	65,000
number_decimal	65,000
number_integer	65,000
rating	65,000
rich_text_field	65,000
single_line_text_field	65,000
url	2,048
volume	65,000
weight	65,000

См. полные ограничения metafield →

🔐 Типы владельцев и доступ (Admin API 2026-07)

Инвентарные перемещения (TRANSFER) — определения metafield для инвентарных перемещений можно экспортировать, импортировать и копировать между магазинами. Для импорта нужно разрешение inventory transfers (read_inventory_transfers, write_inventory_transfers), которое приложение запрашивает начиная с 27 сентября 2026. Пока владелец магазина не откроет DataEase и не одобрит обновлённые разрешения, строки TRANSFER завершаются ошибкой с просьбой их одобрить; все остальные строки импортируются как обычно.
Административный доступ (accessAdmin) в ваших собственных пространствах имён (например, custom) — Shopify допускает там только одно значение, поэтому DataEase не отправляет accessAdmin для таких определений, и Shopify применяет его самостоятельно. Значение PUBLIC_READ / PUBLIC_READ_WRITE в файле больше не вызывает ошибку Shopify.
Административный доступ в пространствах имён приложений ($app, app--…) — MERCHANT_READ и MERCHANT_READ_WRITE отправляются как есть; устаревшие значения PUBLIC_READ / PUBLIC_READ_WRITE из старых файлов отправляются как MERCHANT_READ / MERCHANT_READ_WRITE.

🧰 Пример использования

Добавление пользовательских SEO тегов к продуктам:

Экспортируйте продукты с помощью DataEase
Добавьте новый столбец: metafield global.title_tag [single_line_text_field]
Введите ваши SEO заголовки в столбец
Импортируйте обновленный файл - ваши metafields теперь активны!

✅ Лучшие практики

Используйте правильный формат в квадратных скобках для каждого metafield.
Избегайте перезаписи важных данных - удаляйте столбцы для полей, которые вы не хотите изменять.
Используйте экспорт для резервного копирования ваших текущих metafields перед внесением изменений.

Metafields — это мощный способ расширить функциональность вашего магазина Shopify. С помощью DataEase вы можете управлять ими эффективно - массово - и без необходимости писать код.

Дополнительные поля

Больше столбцов, поддерживаемых DataEase для этой сущности:

accessAdmin — Уровень доступа администратора для определения metafield. Применяется только к пространствам имён приложений (см. Типы владельцев и доступ выше).
accessCustomer — Уровень доступа клиента для определения metafield.
accessStoreFront — Уровень доступа витрины для определения metafield.
capabilitiesAdminFilterableEnabled — Указывает, включена ли фильтрация администратора для metafield.
capabilitiesAdminFilterableEligible — Статус соответствия для возможности фильтрации администратора.
capabilitiesAdminFilterableStatus — Текущий статус возможности фильтрации администратора.
capabilitiesSmartCollectionConditionEnabled — Указывает, включено ли условие умной коллекции для metafield.
capabilitiesSmartCollectionConditionEligible — Статус соответствия для возможности условия умной коллекции.
capabilitiesUniqueValuesEnabled — Указывает, включены ли уникальные значения для metafield.
capabilitiesUniqueValuesEligible — Статус соответствия для возможности уникальных значений.
constraintsKey — Ограничения, применяемые к ключу metafield.
constraintsValues — Ограничения, применяемые к значениям metafield.
metafieldsCount — Количество metafields, связанных с определением.
pinnedPosition — Указывает, закреплен ли metafield в админке.
metafieldsValidationStatus — Статус валидации metafields.
category — Категория определения metafield.
description — Описание определения metafield.
key — Ключ для определения metafield.
name — Название определения metafield.
namespace — Пространство имен для определения metafield.
ownerType — Тип владельца, связанного с определением metafield (например, PRODUCT, CUSTOMER, TRANSFER).
type — Тип данных определения metafield.
validations — JSON массив валидаций для определения metafield.
deleteAssociatedMetafields — Указывает, должны ли быть удалены связанные metafields.