Metafields

Metafields tragen händlerdefinierte Daten — Pflegehinweise, Größentabellen, Zutatenlisten — auf Produkten, Varianten, Collections, Seiten, Artikeln, Blogs und dem Shop selbst. Importierte Shopify-Metafields kommen automatisch mit.

Abfragen

metafields auf jeder unterstützten Entität selektieren:

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

value ist JSON: ein Skalar bei einfachen Typen oder ein Referenz-Payload bei *_reference-Typen.

Rendern

Nach Namespace + Key lesen und auf type verzweigen:

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

Referenzen

file_reference, product_reference (und ihre list.*-Formen) lösen zur referenzierten Entität auf — die CDN-URL einer Datei oder die Kernfelder des referenzierten Produkts — eine Ebene tief. Frage die Felder ab, die du renderst; tief verschachtelte Referenzketten werden bewusst nicht hydriert.