Shopify Metafields: Setup, Metaobjects and Changes Explained

I metafield Shopify sono campi dati personalizzati che alleghi a risorse di negozio esistenti (prodotti, varianti, collezioni, ordini, clienti) per memorizzare informazioni che lo schema predefinito di Shopify non cattura. Ogni tema Online Store 2.0 può visualizzare questi campi come fonti dinamiche senza alcuna modifica al codice. Se hai mai avuto bisogno di mostrare una composizione tessile, un tempo di combustione, un periodo di garanzia o un elenco di ingredienti normativi su una pagina prodotto, i metafield sono lo strumento giusto.

Punti chiave

• I metafield allegano dati aggiuntivi a una risorsa Shopify esistente, mentre i metaobject sono record standalone e riutilizzabili referenziati da molti punti.
• La versione dell'API Shopify 2026-04 ha aggiunto la propagazione automatica dei metafield dal carrello all'ordine, eliminando il divario più grande nei flussi di dati di checkout personalizzati.
• Il limite di valore per metafield è sceso da 2 MB a 16 KB ad aprile 2026, il che significa che qualsiasi cosa più grande deve spostarsi su metaobject o l'API Files.
• I limiti della piattaforma sono ora 256 definizioni app, 256 definizioni commerciante e 1 milione di voci per definizione.
• Il tipo article_reference (aggiunto nella versione dell'API 2025-10) ti permette di collegare i prodotti direttamente ai post del blog per una SEO guidata dai contenuti.

Cos'è esattamente un metafield Shopify?

Un metafield è una coppia chiave-valore strutturata che vive su una risorsa Shopify. Ogni metafield ha quattro attributi richiesti:

• Namespace, un contenitore logico, ad es. custom o my_app
• Key, l'identificatore del campo all'interno di quel namespace, ad es. fabric_type
• Type, il tipo di dato (testo, numero, booleano, riferimento file, JSON, ecc.)
• Value, i dati effettivi che stai memorizzando

La combinazione di namespace e key deve essere univoca per risorsa. Shopify utilizza i namespace per prevenire collisioni tra campi di proprietà dell'app e campi di proprietà del commerciante.

In Liquid, accedi a un metafield del prodotto con:

{{ product.metafields.custom.fabric_type.value }}

Per i campi rich-text, utilizza il filtro metafield_tag per renderizzare correttamente l'output HTML:

{{ product.metafields.custom.care_instructions | metafield_tag }}

Tipi di metafield supportati

Shopify supporta un ampio set di tipi di contenuto. I più comunemente utilizzati sono:

I tipi article_reference e list.article_reference, aggiunti nell'aggiornamento dell'API 2025-10, ti danno un modo nativo per collegare i prodotti ai contenuti editoriali, il che è una vittoria netta per le strategie SEO guidate dai contenuti.

Metafield vs metaobject: la decisione che devi prendere correttamente

Questo è l'errore di architettura più comune che vedo nei negozi dei clienti. La regola è semplice:

Usa un metafield quando i dati sono unici per una risorsa specifica e non hanno valore di riutilizzo.

Usa un metaobject quando lo stesso record strutturato appare in molte risorse o ha bisogno di essere modificato in un unico posto e riflesso ovunque.

Un esempio reale: un commerciante di abbigliamento all'ingrosso ha incollato la stessa tabella di taglie di 18 righe in 247 metafield di prodotto individuali. Quando lo standard di taglie è cambiato, 246 pagine prodotto sono diventate obsolete mentre una è stata aggiornata. La migrazione di quei dati a un singolo metaobject ha richiesto 90 minuti. Ora ogni pagina prodotto che lo referenzia si aggiorna alla prossima richiesta da una singola modifica.

I metaobject sono stati introdotti a febbraio 2023 e sono disponibili su ogni piano Shopify senza restrizioni di piano. Pensa a una definizione di metaobject come a uno schema di tabella di database e a ogni voce come a una riga. Una definizione Size_Guide potrebbe avere campi per titolo, immagine e una tabella di misurazioni. Crei voci (T-Shirt Size Guide, Jeans Size Guide) e le referenzi da quanti prodotti è necessario.

Matrice di decisione rapida:

• Copia specifica del prodotto che un commerciante modifica per SKU? Metafield.
• Grafico taglie condiviso in 50+ SKU di abbigliamento? Metaobject.
• Scadenza di spedizione stagionale che varia per prodotto? Metafield.
• Elenco di rivenditori autorizzati (nome, regione, URL) utilizzato in tutto il sito? Metaobject.
• Record di membro del team referenziato da About, Careers e post del blog? Metaobject.

Il cambio del limite 16 KB che non puoi ignorare (aprile 2026)

Questo è il singolo cambiamento di metafield più dirompente degli ultimi anni. Shopify ha ridotto il tetto del valore per metafield da 2 MB a 16 KB, una riduzione del 99,2%, entrata in vigore ad aprile 2026. La motivazione dichiarata è il costo dell'infrastruttura del database e le prestazioni.

Cosa significa praticamente:

• I metafield JSON utilizzati come mini-database (comuni nelle vecchie integrazioni di app) sono ora rotti o troncati silenziosamente se superano i 16 KB.
• I grandi blocchi rich-text o le immagini incorporate in base64 memorizzate in metafield devono spostarsi all'API Files o essere ristrutturate come metaobject.
• Le nuove implementazioni dovrebbero essere progettate con 16 KB come tetto fin dal primo giorno, affidandosi a metaobject, riferimenti e all'API Files per qualsiasi cosa più pesante.

Se non sei sicuro che il tuo negozio sia interessato, controlla i tuoi metafield tramite l'API Admin GraphQL, interrogando la lunghezza del campo value prima di qualsiasi migrazione.

L'aggiornamento dell'API 2026-04: i metafield del carrello ora passano agli ordini

Questa è la notizia più importante relativa ai metafield per gli sviluppatori del 2026. La versione dell'API Shopify API 2026-04 ha introdotto la propagazione automatica dei metafield del carrello nei metafield dell'ordine quando vengono soddisfatte condizioni specifiche.

Il requisito pratico: lo spazio dei nomi e la chiave devono corrispondere esattamente tra le definizioni di metafield sul lato carrello e sul lato ordine, e la capacità cartToOrderCopyable deve essere abilitata sulla definizione di metafield dell'ordine.

Perché questo è importante per i commercianti: i negozi che raccolgono dati personalizzati al checkout (token di personalizzazione, flag di messaggio regalo, metadati di fedeltà, istruzioni di spedizione di terze parti) in precedenza dovevano affidarsi agli attributi del carrello o script di checkout personalizzati per mantenere quei dati visibili nell'ordine risultante. Questo approccio frammentato è ora sostituito da un modello di metafield unificato con autorizzazioni esplicite e controlli dello spazio dei nomi. Il risultato è un accesso ai controlli più pulito per le app, meno casi limite durante il checkout e un pipeline di dati più prevedibile per i flussi di lavoro di evasione e reporting.

Se utilizzi pipeline ETL per esportare ordini per la riconciliazione finanziaria o ERP, aggiorna i tuoi mapping di campi per includere i valori di metafield dell'ordine rilevanti.

Come creare definizioni di metafield (nessun codice richiesto)

1. Vai a Shopify Admin > Settings > Custom data.
2. Scegli il tipo di risorsa (Prodotti, Varianti, Collezioni, Clienti, Ordini, ecc.).
3. Fai clic su Add definition.
4. Immetti un nome, uno spazio dei nomi, una chiave e seleziona il tipo di contenuto.
5. Aggiungi convalide opzionali (limiti di caratteri, formato URL, intervalli numerici).
6. Salva.

Una volta che una definizione esiste, qualsiasi sezione del tema Online Store 2.0 che supporti fonti dinamiche la esporrà come campo selezionabile nell'editor del tema, nessuna modifica Liquid necessaria.

Per la popolazione di massa, l'importazione CSV nativa di Shopify gestisce un set limitato di colonne metafield. Per il controllo completo, Matrixify è lo strumento di fatto: mappa le colonne CSV direttamente alle coppie spazio dei nomi-chiave e convalida i tipi durante l'importazione.

Rendering dei metafield nel tuo tema

Fonti dinamiche (percorso senza codice)

Nell'editor del tema, fai clic su qualsiasi testo, immagine o blocco multimediale in una sezione OS 2.0, quindi fai clic sull'icona Connect dynamic source (l'icona del database). I tuoi metafield definiti appaiono come opzioni. Questo è il percorso corretto per gli editor di contenuti che non dovrebbero toccare il codice.

Liquid (percorso del codice)

Per sezioni personalizzate o logica condizionale, scrivilo direttamente in Liquid:

{% if product.metafields.custom.is_hazardous.value %}
  <p class="hazard-notice">⚠ Handle with care. See safety sheet.</p>
{% endif %}

{% assign warranty = product.metafields.custom.warranty_years.value %}
{% if warranty %}
  <p>{{ warranty }}-year warranty included.</p>
{% endif %}

Shopify Flow (percorso automazione)

Da aprile 2024, Shopify Flow può leggere metafield tipizzati direttamente. Selezioni una risorsa, scegli un metafield dall'elenco delle definizioni conosciute e Flow genera un alias che usi nei passaggi successivi. Questo è utile per automatizzare l'etichettatura, le notifiche o il routing dell'evasione in base ai valori dei metafield, senza app personalizzate.

Metafield per SEO: l'opportunità article_reference

La SEO guidata dai contenuti è uno dei usi con il ROI più alto dei metafield in questo momento. Con il tipo article_reference disponibile dalla versione dell'API 2025-10, puoi collegare un prodotto direttamente a un post di blog specifico all'interno della definizione di metafield del prodotto. L'URL del post del blog diventa un riferimento strutturato anziché una stringa hardcoded, il che significa che sopravvive ai cambiamenti di handle e non richiede aggiornamenti manuali su centinaia di prodotti.

Questo è importante per la SEO perché crea una struttura di link interni navigabile che i crawler possono seguire e mantiene il contenuto editoriale di supporto contextualmente vicino alla pagina transazionale. Per i negozi con una grande libreria di guide di acquisto o articoli how-to, questo vale la pena implementare sistematicamente nel tuo catalogo.

Per uno sguardo più ampio a come i dati strutturati e l'organizzazione dei contenuti influenzano la visibilità di ricerca del tuo negozio, vedi le nostre pagine servizi SEO Shopify e sviluppo tema Shopify.

Limiti della piattaforma a colpo d'occhio (aggiornato a metà 2026)

Errori comuni da evitare

• Memorizzare grandi blob JSON in un singolo metafield. Da aprile 2026 il limite è di 16 KB. Usa metaobject o suddividi i dati in campi tipizzati più piccoli.
• Duplicare dati condivisi su migliaia di prodotti. Se lo stesso valore appare su più di una manciata di prodotti, appartiene a un metaobject.
• Rinominare metafield in produzione mentre il tema li referenzia. Aggiorna prima i riferimenti del tema, poi rinomina la definizione. Invertire quell'ordine interrompe l'output della vetrina live.
• Saltare le definizioni e utilizzare coppie spazio dei nomi-chiave non elaborate. Senza una definizione, perdi la convalida del tipo, il supporto delle fonti dinamiche nell'editor del tema e la visualizzazione UI amministratore pulita.
• Utilizzare lo spazio dei nomi global. Le app precedentemente utilizzavano global.title e pattern simili. Quello spazio dei nomi è riservato e il suo comportamento è incoerente tra le versioni dell'API. Usa uno spazio dei nomi personalizzato.
• Non controllare i metafield delle app legacy. Le app precedenti lasciano dietro metafield orfani sotto spazi dei nomi come namespace_1 o apps.my_old_app. Questi contano rispetto ai tuoi limiti di definizione e inquinano l'UI amministratore.