Shopify Metafields: Setup, Metaobjects en wijzigingen uitgelegd

Shopify metafields zijn custom gegevensvelden die je toevoegt aan bestaande winkelresources (producten, varianten, collecties, bestellingen, klanten) om informatie op te slaan die Shopify's standaardschema niet ondersteunt. Elk Online Store 2.0 thema kan deze velden als dynamische bronnen tonen zonder codewijzigingen. Als je ooit stoffensamenstelling, brandtijd, garantieperiode of regelgeving ingredientenlijsten op een productpagina moet weergeven, zijn metafields het juiste gereedschap.

Belangrijkste punten

• Metafields voegen extra gegevens toe aan een bestaande Shopify-resource; metaobjects zijn zelfstandige, herbruikbare records waarnaar op veel plaatsen wordt verwezen.
• Shopify API-versie 2026-04 voegde automatische propagatie van wagen- naar bestelmetafields toe, waardoor de grootste hiaat in custom checkoutgegevensstromen werd opgeheven.
• De waardecap per metafield daalde in april 2026 van 2 MB naar 16 KB, wat betekent dat alles groters naar metaobjects of de Files API moet.
• Platformlimieten zijn nu 256 app-definities, 256 merchant-definities en 1 miljoen entries per definitie.
• Het type article_reference (toegevoegd in de 2025-10 API-release) laat je producten rechtstreeks aan blogposts koppelen voor content-gerichte SEO.

Wat is precies een Shopify metafield?

Een metafield is een gestructureerd sleutel-waardepaar dat zich op een Shopify-resource bevindt. Elk metafield heeft vier vereiste attributen:

• Namespace, een logische container, bijv. custom of my_app
• Key, de veldidentificatie binnen die naamruimte, bijv. fabric_type
• Type, het gegevenstype (tekst, getal, booleaans, bestandsreferentie, JSON, enzovoort)
• Value, de werkelijke gegevens die je opslaat

De combinatie van namespace en key moet uniek zijn per resource. Shopify gebruikt namespaces om botsingen tussen app-eigendomsgegevens en merchant-eigendomsgegevens te voorkomen.

In Liquid benaad je een productmetafield met:

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

Voor rich-text-velden gebruik je het filter metafield_tag om HTML-uitvoer correct weer te geven:

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

Ondersteunde metafield-typen

Shopify ondersteunt een breed scala aan inhoudstypen. De meest gebruikte zijn:

De typen article_reference en list.article_reference, toegevoegd in de 2025-10 API-update, geven je een native manier om producten aan redactionele inhoud te koppelen, wat een schone winst is voor content-gerichte SEO-strategieën.

Metafields versus metaobjects: de beslissing die je goed moet nemen

Dit is de meest voorkomende architectuurfout die ik op klantenwinkels zie. De regel is simpel:

Gebruik een metafield wanneer de gegevens uniek zijn voor één specifieke resource en geen hergebruikswaarde hebben.

Gebruik een metaobject wanneer dezelfde gestructureerde record op veel resources voorkomt of op één plaats moet worden bewerkt en overal moet worden weerspiegeld.

Een echt voorbeeld: één groothandelse kledinghandelaar plakte dezelfde 18-rij groottekaart in 247 individuele productmetafields. Toen de grootte standaard veranderde, werden 246 productpagina's verouderd terwijl één werd bijgewerkt. Het migreren van die gegevens naar één metaobject duurde 90 minuten. Nu wordt elke productpagina die ernaar verwijst bij de volgende aanvraag vanuit één bewerking bijgewerkt.

Metaobjects werden in februari 2023 geïntroduceerd en zijn beschikbaar op elk Shopify-plan zonder planinperkingen. Denk aan een metaobjectdefinitie als een databasetabelschema en aan elke vermelding als een rij. Een definitie Size_Guide kan velden voor titel, afbeelding en een metingstabel hebben. Je maakt vermeldingen (T-Shirt Size Guide, Jeans Size Guide) en verwijst ernaar vanuit zoveel producten als nodig.

Snelle beslissingsmatrix:

• Productspecifieke kopie die een merchant per SKU bewerkt? Metafield.
• Groottekaart gedeeld over 50+ kledingstukken SKU's? Metaobject.
• Seizoensgebonden verzenddeadline die per product verschilt? Metafield.
• Geautoriseerde wederverkoperlijst (naam, regio, URL) die site-breed wordt gebruikt? Metaobject.
• Teamlid opgenomen waarnaar van About, Careers en blogposts wordt verwezen? Metaobject.

De 16 KB-limitwijziging die je niet kunt negeren (april 2026)

Dit is de meest disruptieve metafieldwijziging van recente jaren. Shopify verlaagde de waardeplafond per metafield van 2 MB naar 16 KB, een verlaging van 99,2%, die in april 2026 van kracht is geworden. De gegeven reden is de kosten en prestaties van database-infrastructuur.

Dit betekent praktisch:

• JSON metafields gebruikt als mini-databases (gewoon in oudere app-integraties) zijn nu verbroken of stilzwijgend afgekapt als ze groter zijn dan 16 KB.
• Grote rich-text blokken of ingebedde base64-afbeeldingen opgeslagen in metafields moeten naar de Files API of worden herstructureerd als metaobjects.
• Nieuwe implementaties moeten van dag één met 16 KB als plafond worden ontworpen, steunend op metaobjects, referenties en de Files API voor alles zwaardere.

Als je niet zeker weet of je winkel getroffen is, controleer je metafields via de Admin GraphQL API en vraag de value veldlengte op voordat je migreert.

De 2026-04 API-update: wagensmetafields worden nu naar bestellingen overgedragen

Dit is het grootste voor ontwikkelaars relevante metafieldnieuws van 2026. Shopify API-versie 2026-04 introduceerde automatische propagatie van wagensmetafields naar bestellingsmetafields wanneer aan bepaalde voorwaarden is voldaan.

De praktische vereiste: de namespace en key moeten exact overeenkomen tussen de wagenzijde en bestellingszijde metafieldefinities, en het vermogen cartToOrderCopyable moet zijn ingeschakeld op de bestellingsmetafieldefinitie.

Waarom dit belangrijk is voor merchants: winkels die custom gegevens bij checkout verzamelen (personalisatietokens, geschenk berichtenvlaggen, loyaliteitsmetadata, instructies van derden voor verzending) moeten zich voorheen verlaten op wagenskenmerken of custom checkoutscripts om die gegevens zichtbaar te houden op de resulterende bestelling. Die gefragmenteerde aanpak wordt nu vervangen door een uniform metafieldmodel met expliciete machtigingen en naamruimtebesturingselementen. Het resultaat is schonere toegangsbesturingselementen voor apps, minder randgevallen tijdens checkout en een voorspelbaarder gegevensleidingpad voor vervullings- en rapportageworkflows.

Als je ETL-pijplijnen gebruikt om bestellingen voor financiering of ERP-afstemming uit te voeren, werk je veldtoewijzingen bij om de relevante bestellingsmetafieldwaarden op te nemen.

Hoe metafieldefinities maken (geen code vereist)

1. Ga naar Shopify Admin > Instellingen > Custom data.
2. Kies het resourcetype (Producten, Varianten, Collecties, Klanten, Bestellingen, enz.).
3. Klik op Definitie toevoegen.
4. Voer een naam, namespace, key in en selecteer het inhoudstype.
5. Voeg optionele validaties toe (tekenlimiet, URL-indeling, numerieke bereiken).
6. Opslaan.

Zodra een definitie bestaat, zal elk Online Store 2.0 themasectie dat dynamische bronnen ondersteunt, dit als selecteerbaar veld in de themaredacteur tonen, zonder Liquid bewerking nodig.

Voor bulkpopulatie verwerkt Shopify's native CSV-import een beperkt aantal metafieldkolommen. Voor volledige controle is Matrixify het feitelijke hulpmiddel: het wijst CSV-kolommen rechtstreeks toe aan naamruimte-sleutelparen en valideert typen tijdens import.

Metafields in je thema weergeven

Dynamische bronnen (code-vrije pad)

Klik in de themaredacteur op een tekst-, afbeeldings- of mediablock in een OS 2.0 sectie en klik vervolgens op het pictogram Dynamische bron verbinden (het databasepictogram). Je gedefinieerde metafields verschijnen als opties. Dit is het juiste pad voor content-editors die geen code mogen aanraken.

Liquid (codeerpad)

Voor custom secties of voorwaardelijke logica, schrijf het rechtstreeks 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 (automatiseringspad)

Sinds april 2024 kan Shopify Flow getypeerde metafields rechtstreeks lezen. Je selecteert een resource, kiest een metafield uit de bekende definitieslijst en Flow genereert een alias die je in volgende stappen gebruikt. Dit is handig voor het automatiseren van tagging, meldingen of vervullingsrouting op basis van metafieldwaarden, zonder aangepaste apps.

Metafields voor SEO: de mogelijkheid van article_reference

Content-gerichte SEO is momenteel een van de meest rendabele toepassingen van metafields. Met het type article_reference beschikbaar sinds de 2025-10 API, kun je een product rechtstreeks aan een specifieke blogpost koppelen vanuit de metafielddefintie. De blogpost URL wordt een gestructureerde referentie in plaats van een hardgecodeerde tekenreeks, wat betekent dat deze overleeft bij handleiwijzigingen en geen handmatige updates over honderden producten vereist.

Dit is belangrijk voor SEO omdat het een navigeerbare interne linkstructuur creëert die crawlers kunnen volgen, en het houdt de ondersteunende redactionele inhoud contextueel dicht bij de transactiepagina. Voor winkels met een grote bibliotheek van aankoopgidsen of instructieartikelen is dit de moeite waard om systematisch over je catalogus uit te voeren.

Voor een breder overzicht van hoe gestructureerde gegevens en content-organisatie de zoekvisbiliteit van je winkel beïnvloeden, raadpleeg onze Shopify SEO-services en Shopify-themeontwikkelings pagina's.

Platformlimieten in een oogopslag (actueel medio 2026)

Veelgemaakte fouten om te voorkomen

• Grote JSON-blobs in één metafield opslaan. Sinds april 2026 is het plafond 16 KB. Gebruik metaobjects of verdeel de gegevens in kleinere getypeerde velden.
• Gedeelde gegevens dupliceren over duizenden producten. Als dezelfde waarde op meer dan enkele producten verschijnt, hoort het in een metaobject.
• Metafields hernoemen in productie terwijl het thema ernaar verwijst. Werk themeverwijzingen eerst bij, hernoem vervolgens de definitie. Het omkeren van die volgorde breekt live storefrontuitvoer.
• Definities overslaan en onbewerkte naamruimte-sleutelparen gebruiken. Zonder een definitie verlies je typvalidatie, ondersteuning van dynamische bronnen in de themaredacteur en schone admin UI-weergave.
• De naamruimte global gebruiken. Apps gebruikten voorheen global.title en vergelijkbare patronen. Die naamruimte is gereserveerd en het gedrag ervan is inconsistent over API-versies. Gebruik een aangepaste naamruimte.
• Geen controle van oudere app-metafields. Oudere apps laten weesmetafields achter onder naamruimten zoals namespace_1 of apps.my_old_app. Deze tellen mee voor je definitielimieten en vervuilen de admin UI.