Metafields

I metafields contengono dati definiti dal commerciante — istruzioni di cura, tabelle delle taglie, elenchi di ingredienti — su prodotti, varianti, collezioni, pagine, articoli, blog e sul negozio stesso. I metafields Shopify importati arrivano automaticamente.

Esecuzione delle query

Seleziona metafields su qualsiasi entità che lo supporta:

query Product($handle: String!) {
  product(handle: $handle) {
    id
    title
    metafields {
      namespace
      key
      type
      value
    }
  }
}

value è JSON: uno scalare per tipi semplici, o un payload di riferimento per tipi *_reference.

Rendering

Leggi per namespace + chiave e branch su type:

const care = product.metafields?.find((m) => m.namespace === "custom" && m.key === "care");
if (care?.type === "multi_line_text_field") {
  /* render the text */
}

Riferimenti

file_reference, product_reference (e le loro forme list.*) risolvono all’entità di riferimento — l’URL CDN di un file, o i campi principali del prodotto di riferimento — un livello in profondità. Interroga i campi che renderizzi; le catene di riferimento annidate sono intenzionalmente non idratate.