Definiția Metafield

Metafield-urile vă permit să stocați date personalizate pentru produse, comenzi, clienți și alte resurse în Shopify. Ele sunt utile pentru a adăuga informații suplimentare precum ghiduri de mărimi, specificații, date SEO sau note interne.

Aflați mai multe despre metafield-uri în Shopify →

Cu DataEase, puteți importa, exporta și actualiza metafield-uri ușor folosind coloane dinamice în fișierele dumneavoastră.

📊 Cum Funcționează Metafield-urile în DataEase

Când exportați date din DataEase, metafield-urile sunt afișate ca coloane dinamice. Aceasta înseamnă că fiecare metafield primește propria sa coloană în fișier, folosind un format specific de denumire:

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

Exemplu:

metafield global.description_tag [single_line_text_field]

Această structură indică DataEase (și Shopify) la ce metafield vă referiți și în ce format.

🧠 Logica de Import a Metafield-urilor

Dacă un metafield nu este în fișierul de import, acesta nu va fi schimbat.
Dacă un metafield este în fișier dar gol, acesta va fi șters din Shopify.
Dacă un metafield are o valoare, acesta va fi creat sau actualizat.

Acest lucru face ușoară gestionarea metafield-urilor fără a suprascrie datele pe care nu doriți să le modificați.

🧩 Tipuri de Metafield-uri Suportate

Shopify suportă o gamă largă de tipuri de metafield-uri. Puteți vedea lista completă aici:

Folosiți aceste tipuri în anteturile coloanelor atunci când importați. De exemplu:

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

📏 Limitele Metafield-urilor

Înainte de a lucra cu metafield-uri, fiți conștienți de limitele Shopify:

🔢 Limite per resursă

250 definiții per tip de resursă
20 definiții fixate per tip de resursă

📦 Limite de caractere pe tip

Tip	Limită de Caractere
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

Vezi limitele complete ale metafield-urilor →

🔐 Tipuri de proprietar și acces (Admin API 2026-07)

Transferuri de inventar (TRANSFER) — definițiile de metafield ale transferurilor de inventar pot fi exportate, importate și copiate între magazine. Importul lor necesită permisiunea de transferuri de inventar (read_inventory_transfers, write_inventory_transfers), pe care aplicația o solicită începând cu 27 sept. 2026. Până când proprietarul magazinului deschide DataEase și aprobă permisiunile actualizate, rândurile TRANSFER eșuează cu o eroare care cere aprobarea lor; toate celelalte rânduri sunt importate ca de obicei.
Acces admin (accessAdmin) în namespace-urile dumneavoastră proprii (de exemplu custom) — Shopify permite o singură valoare acolo, așa că DataEase nu trimite accessAdmin pentru astfel de definiții, iar Shopify îl aplică singur. O valoare PUBLIC_READ / PUBLIC_READ_WRITE din fișier nu mai provoacă o eroare Shopify.
Acces admin în namespace-uri de aplicații ($app, app--…) — MERCHANT_READ și MERCHANT_READ_WRITE sunt trimise ca atare; valorile vechi PUBLIC_READ / PUBLIC_READ_WRITE din fișiere mai vechi sunt trimise ca MERCHANT_READ / MERCHANT_READ_WRITE.

🧰 Exemplu de Utilizare

Adăugați etichete SEO personalizate produselor:

Exportați produsele cu DataEase
Adăugați o nouă coloană: metafield global.title_tag [single_line_text_field]
Introduceți titlurile SEO în coloană
Importați fișierul actualizat - metafield-urile dumneavoastră sunt acum active!

✅ Cele Mai Bune Practici

Utilizați formatul corect în paranteze pătrate pentru fiecare metafield.
Evitați suprascrierea datelor importante - eliminați coloanele pentru câmpurile pe care nu doriți să le modificați.
Folosiți exportul pentru a face backup metafield-urilor curente înainte de a face modificări.

Metafield-urile sunt o modalitate puternică de a extinde funcționalitatea magazinului dumneavoastră Shopify. Cu DataEase, le puteți gestiona eficient - în masă - și fără a fi nevoie să scrieți cod.

Câmpuri suplimentare

Mai multe coloane pe care DataEase le suportă pentru această entitate:

accessAdmin — Nivelul de acces al administratorului pentru definiția metafield-ului. Se aplică doar namespace-urilor de aplicații (vezi Tipuri de proprietar și acces mai sus).
accessCustomer — Nivelul de acces al clientului pentru definiția metafield-ului.
accessStoreFront — Nivelul de acces al vitrinei pentru definiția metafield-ului.
capabilitiesAdminFilterableEnabled — Indică dacă filtrarea de către administrator este activată pentru metafield.
capabilitiesAdminFilterableEligible — Starea de eligibilitate pentru capacitatea de filtrare de către administrator.
capabilitiesAdminFilterableStatus — Starea curentă a capacității de filtrare de către administrator.
capabilitiesSmartCollectionConditionEnabled — Indică dacă condiția de colecție inteligentă este activată pentru metafield.
capabilitiesSmartCollectionConditionEligible — Starea de eligibilitate pentru capacitatea de condiție de colecție inteligentă.
capabilitiesUniqueValuesEnabled — Indică dacă valorile unice sunt activate pentru metafield.
capabilitiesUniqueValuesEligible — Starea de eligibilitate pentru capacitatea de valori unice.
constraintsKey — Constrângerile aplicate cheii metafield-ului.
constraintsValues — Constrângerile aplicate valorilor metafield-ului.
metafieldsCount — Numărul de metafield-uri asociate cu definiția.
pinnedPosition — Indică dacă metafield-ul este fixat în admin.
metafieldsValidationStatus — Starea de validare a metafield-urilor.
category — Categoria definiției metafield-ului.
description — Descrierea definiției metafield-ului.
key — Cheia pentru definiția metafield-ului.
name — Numele definiției metafield-ului.
namespace — Namespace pentru definiția metafield-ului.
ownerType — Tipul de proprietar asociat cu definiția metafield-ului (de exemplu PRODUCT, CUSTOMER, TRANSFER).
type — Tipul de date al definiției metafield-ului.
validations — Array JSON de validări pentru definiția metafield-ului.
deleteAssociatedMetafields — Indică dacă metafield-urile asociate ar trebui șterse.