Definicja Metafield

Metafieldy pozwalają przechowywać dane niestandardowe dla produktów, zamówień, klientów i innych zasobów w Shopify. Są przydatne do dodawania dodatkowych informacji, takich jak przewodniki rozmiarów, specyfikacje, dane SEO lub notatki wewnętrzne.

Dowiedz się więcej o metafieldach w Shopify →

Dzięki DataEase możesz importować, eksportować i aktualizować metafieldy łatwo, używając dynamicznych kolumn w swoich plikach.

📊 Jak działają metafieldy w DataEase

Kiedy eksportujesz dane z DataEase, metafieldy są wyświetlane jako dynamiczne kolumny. Oznacza to, że każdy metafield otrzymuje własną kolumnę w pliku, używając określonego formatu nazewnictwa:

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

Przykład:

metafield global.description_tag [single_line_text_field]

Ta struktura informuje DataEase (i Shopify), do którego metafieldu się odnosisz i w jakim formacie.

🧠 Logika importu metafieldów

Jeśli metafield nie znajduje się w pliku importu, nie zostanie zmieniony.
Jeśli metafield jest w pliku, ale pusty, zostanie usunięty z Shopify.
Jeśli metafield ma wartość, zostanie utworzony lub zaktualizowany.

To ułatwia zarządzanie metafieldami bez nadpisywania danych, których nie chcesz zmieniać.

🧩 Obsługiwane typy metafieldów

Shopify obsługuje szeroki zakres typów metafieldów. Pełną listę można zobaczyć tutaj:

Używaj tych typów w nagłówkach kolumn podczas importu. Na przykład:

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

📏 Limity metafieldów

Przed pracą z metafieldami, bądź świadomy limitów Shopify:

🔢 Limity na zasób

250 definicji na typ zasobu
20 przypiętych definicji na typ zasobu

📦 Limity znaków według typu

Typ	Limit znaków
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

Zobacz pełne limity metafieldów →

🔐 Typy właścicieli i dostęp (Admin API 2026-07)

Przenoszenia zapasów (TRANSFER) — definicje metafieldów dla przenoszeń zapasów można eksportować, importować i kopiować między sklepami. Import wymaga uprawnienia inventory transfers (read_inventory_transfers, write_inventory_transfers), o które aplikacja prosi od 27 września 2026. Dopóki właściciel sklepu nie otworzy DataEase i nie zatwierdzi zaktualizowanych uprawnień, wiersze TRANSFER kończą się błędem z prośbą o ich zatwierdzenie; wszystkie pozostałe wiersze są importowane jak zwykle.
Dostęp administratora (accessAdmin) we własnych przestrzeniach nazw (na przykład custom) — Shopify dopuszcza tam tylko jedną wartość, więc DataEase nie wysyła accessAdmin dla takich definicji, a Shopify stosuje ją samodzielnie. Wartość PUBLIC_READ / PUBLIC_READ_WRITE w pliku nie powoduje już błędu Shopify.
Dostęp administratora w przestrzeniach nazw aplikacji ($app, app--…) — MERCHANT_READ i MERCHANT_READ_WRITE są wysyłane bez zmian; przestarzałe wartości PUBLIC_READ / PUBLIC_READ_WRITE ze starszych plików są wysyłane jako MERCHANT_READ / MERCHANT_READ_WRITE.

🧰 Przykład użycia

Dodaj niestandardowe tagi SEO do produktów:

Eksportuj produkty z DataEase
Dodaj nową kolumnę: metafield global.title_tag [single_line_text_field]
Wprowadź swoje tytuły SEO w kolumnie
Zaimportuj zaktualizowany plik - twoje metafieldy są teraz aktywne!

✅ Najlepsze praktyki

Używaj poprawnego formatu w nawiasach kwadratowych dla każdego metafieldu.
Unikaj nadpisywania ważnych danych - usuń kolumny dla pól, których nie chcesz zmieniać.
Użyj eksportu, aby wykonać kopię zapasową obecnych metafieldów przed wprowadzeniem zmian.

Metafieldy to potężny sposób na rozszerzenie funkcjonalności sklepu Shopify. Dzięki DataEase możesz nimi zarządzać efektywnie - masowo - i bez potrzeby pisania kodu.

Dodatkowe pola

Więcej kolumn obsługiwanych przez DataEase dla tej jednostki:

accessAdmin — Poziom dostępu administratora dla definicji metafieldu. Stosowany tylko do przestrzeni nazw aplikacji (zobacz Typy właścicieli i dostęp powyżej).
accessCustomer — Poziom dostępu klienta dla definicji metafieldu.
accessStoreFront — Poziom dostępu do witryny dla definicji metafieldu.
capabilitiesAdminFilterableEnabled — Wskazuje, czy filtrowanie administratora jest włączone dla metafieldu.
capabilitiesAdminFilterableEligible — Status kwalifikacji dla możliwości filtrowania administratora.
capabilitiesAdminFilterableStatus — Aktualny status możliwości filtrowania administratora.
capabilitiesSmartCollectionConditionEnabled — Wskazuje, czy warunek inteligentnej kolekcji jest włączony dla metafieldu.
capabilitiesSmartCollectionConditionEligible — Status kwalifikacji dla możliwości warunku inteligentnej kolekcji.
capabilitiesUniqueValuesEnabled — Wskazuje, czy unikalne wartości są włączone dla metafieldu.
capabilitiesUniqueValuesEligible — Status kwalifikacji dla możliwości unikalnych wartości.
constraintsKey — Ograniczenia zastosowane do klucza metafieldu.
constraintsValues — Ograniczenia zastosowane do wartości metafieldu.
metafieldsCount — Liczba metafieldów powiązanych z definicją.
pinnedPosition — Wskazuje, czy metafield jest przypięty w panelu administratora.
metafieldsValidationStatus — Status walidacji metafieldów.
category — Kategoria definicji metafieldu.
description — Opis definicji metafieldu.
key — Klucz dla definicji metafieldu.
name — Nazwa definicji metafieldu.
namespace — Przestrzeń nazw dla definicji metafieldu.
ownerType — Typ właściciela powiązanego z definicją metafieldu (na przykład PRODUCT, CUSTOMER, TRANSFER).
type — Typ danych definicji metafieldu.
validations — Tablica JSON walidacji dla definicji metafieldu.
deleteAssociatedMetafields — Wskazuje, czy powiązane metafieldy powinny zostać usunięte.