Contact

JSON-LD vs Microdata: welke markup kies je in 2026?

door | aug 15, 2026 | SEO | 0 Reacties

Iemand zit achter zijn laptop en voert JSON-LD code in met snelle vingers op het toetsenbord.

Kies JSON-LD voor nieuwe implementaties. Dat is het advies van Google Search Central, en in de praktijk is het ook gewoon de betere keuze. Microdata werkt nog steeds, maar het is fragieler en moeilijker te onderhouden. Houd het alleen in stand als je een bestaande site hebt waar migratie meer kost dan het oplevert.

De drie belangrijkste redenen om JSON-LD te kiezen:

  • Google beveelt het aan als standaard voor gestructureerde data, expliciet boven Microdata.
  • Onderhoud is eenvoudiger: JSON-LD staat los van je HTML, dus een templatewijziging breekt je markup niet.
  • CMS-compatibiliteit: in WordPress, Drupal en vergelijkbare systemen is JSON-LD via plugins of template-hooks te injecteren zonder de HTML aan te raken.

Microdata behoud je alleen als je een legacy-site hebt met werkende implementaties die goed presteren, en waarbij de migratieinspanning niet opweegt tegen het voordeel.

Belangrijkste inzichten

JSON-LD is de aanbevolen standaard voor gestructureerde data op nieuwe projecten, ondersteund door Google en eenvoudiger te onderhouden dan Microdata.

Punt Details
Kies JSON-LD voor nieuwe projecten Google beveelt JSON-LD expliciet aan; het is losgekoppeld van HTML en daardoor minder kwetsbaar.
Behoud werkende Microdata Verwijder Microdata alleen als JSON-LD gevalideerd is en rich results bevestigd zijn in Search Console.
Valideer altijd voor livegang Gebruik de Schema Markup Validator en Rich Results Test op elke staging-omgeving.
Monitor via Search Console Volg fouten, gedetecteerde items en CTR van rich results minimaal vier weken na uitrol.
Nebber voor audit en migratie Nebber levert een technische audit en gefaseerd migratieplan voor teams die dit willen uitbesteden.

Inhoudsopgave

Hoe verhouden JSON-LD en Microdata zich tot elkaar?

Criterium JSON-LD Microdata
Aanbeveling door Google Aanbevolen Ondersteund, niet aanbevolen
Implementatiewrijving Laag: apart blok in <head> of <body> Hoog: inline in HTML-elementen
Onderhoud en schaalbaarheid Goed: losgekoppeld van HTML Risicovol: breekt bij HTML-wijzigingen
Breekrisico bij templatewijzigingen Laag Hoog
Integratie met CMS of frontend Eenvoudig via hooks of plugins Vereist HTML-aanpassingen
Test- en validatieopties Rich Results Test, Schema Markup Validator, JSON-linters Rich Results Test, Schema Markup Validator
Beste gebruiksscenario Nieuwe projecten, dynamische CMS, schaalbare sites Legacy-sites met werkende implementaties

In Nederlandse CMS-omgevingen zoals WordPress is het verschil concreet: een JSON-LD-blok overleeft een thema-update, terwijl Microdata-attributen stil kunnen verdwijnen als een developer een extra wrapper toevoegt. Bij statische pagina’s is het risico kleiner, maar ook daar biedt JSON-LD meer flexibiliteit bij doorontwikkeling.

Hoe werkt gestructureerde data en waarom geeft Google erom?

Gestructureerde data is een gestandaardiseerde manier om zoekmachines te vertellen wat de inhoud van een pagina betekent, niet alleen wat er staat. Het vocabulaire komt van Schema, een gezamenlijk initiatief van Google, Bing, Yahoo en Yandex. De keuze tussen JSON-LD en Microdata verandert de semantiek niet: beide gebruiken dezelfde schema.org-types en properties.

Hoe Googlebot dit verwerkt:

  • De crawler leest de gestructureerde data uit tijdens het renderen van de pagina.
  • Google controleert of de vereiste properties aanwezig zijn voor een specifiek rich result-type (bijv. Review, Event, LocalBusiness).
  • Bij een geldige implementatie komt de pagina in aanmerking voor rich results: sterschema’s, FAQ-blokken, evenementinformatie in de zoekresultaten.
  • Fouten in de markup blokkeren eligibility, ook als de rest van de pagina perfect is.

Naast JSON-LD en Microdata ondersteunt Google ook RDFa, maar dat formaat is in de praktijk zelden nodig voor standaard SEO-toepassingen. JSON-LD volstaat in vrijwel alle gevallen.

Valideer je implementatie altijd met de Schema Markup Validator en de Rich Results Test op search.google.com/test/rich-results. Google Search Console toont daarna welke rich results Google daadwerkelijk herkent op jouw domein.

Wat zijn de voordelen en beperkingen van JSON-LD?

JSON-LD is losgekoppeld van je HTML en daardoor het makkelijkst te onderhouden. Je plaatst één <script type="application/ld+json">-blok in de <head> of <body>, en de rest van je template raakt het niet. Dat is het kernvoordeel.

Voordelen:

  • Volledig los van de HTML-structuur: templatewijzigingen breken de markup niet.
  • Eenvoudig te valideren met JSON-linters en de Schema Markup Validator.
  • Makkelijk te templaten in CMS-omgevingen: één centraal blok per pagina-type.
  • Dynamisch te injecteren via server-side templates of CMS-hooks.
  • Goed leesbaar voor developers die niet bekend zijn met schema.org-syntax.

Beperkingen:

  • Client-side injectie via JavaScript kan problemen geven als Googlebot de pagina niet volledig rendert.
  • Bij complexe geneste entiteiten kan het JSON-blok groot worden en overzicht vereisen.
  • Zonder goede templating kun je per ongeluk verouderde data in het blok laten staan.

Een voorbeeld voor een Nederlands lokaal bedrijf:

{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Bakkerij De Molen",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Marktstraat 12",
    "addressLocality": "Eindhoven",
    "postalCode": "5611 EC",
    "addressCountry": "NL"
  },
  "openingHours": "Mo-Fr 08:00-18:00",
  "telephone": "+31 40 123 4567"
}

Dit blok staat in de <head> van de pagina en raakt de zichtbare HTML niet. Wijzig je het adres? Eén aanpassing in het JSON-blok, klaar.

Pro-tip: Injecteer JSON-LD server-side via je CMS-template of build-systeem. Client-side injectie via JavaScript werkt alleen betrouwbaar als je zeker weet dat Googlebot de pagina volledig rendert. Bij twijfel: server-side is altijd veiliger voor SEO-kritische data.

Wanneer is Microdata nog een logische keuze?

Microdata is onderdeel van de HTML-specificatie en plaatst metadata direct als attributen (itemscope, itemtype, itemprop) in je HTML-elementen. Het werkt, maar het is vergroeid met je markup.

Voordelen:

  • Geen apart script-blok nodig: de data zit in de HTML die de gebruiker al ziet.
  • Goed voor eenvoudige, statische pagina’s met weinig templatewijzigingen.
  • Werkt in omgevingen waar script-injectie beperkt is.

Risico’s en nadelen:

  • Een extra <div> of gewijzigde class van een developer kan een itemprop-keten stilletjes breken.
  • Moeilijker te debuggen: de markup is verspreid over de hele HTML.
  • Slecht schaalbaar bij meerdere pagina-types of grote sites.
  • Hogere kans op fouten bij CMS-updates, thema-wissels of page-builder aanpassingen.

Hetzelfde lokale bedrijf in Microdata:

<div itemscope itemtype="https://schema.org/LocalBusiness">
  <span itemprop="name">Bakkerij De Molen</span>
  <div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">
    <span itemprop="streetAddress">Marktstraat 12</span>
    <span itemprop="addressLocality">Eindhoven</span>
    <span itemprop="postalCode">5611 EC</span>
    <span itemprop="addressCountry">NL</span>
  </div>
  <span itemprop="telephone">+31 40 123 4567</span>
</div>

Microdata is valide en door Google ondersteund, maar de inline verwevenheid met HTML maakt het kwetsbaar. Eén templatewijziging die een wrapper-element toevoegt of verplaatst, kan de hele itemprop-keten breken zonder dat er een foutmelding verschijnt in de browser.

Praktijkdiscussies op Stack Overflow bevestigen dit patroon: developers kiezen JSON-LD zodra ze de eerste keer een Microdata-implementatie zien breken na een thema-update.

Pro-tip: Heb je werkende Microdata op een site die goed presteert? Laat het staan. Verwijder het niet zonder reden. Maar start nooit een nieuw project met Microdata: je bouwt onnodige kwetsbaarheid in.

Hoe implementeer je JSON-LD betrouwbaar en welke tools gebruik je?

De implementatiemethode bepaalt hoe stabiel je gestructureerde data blijft bij doorontwikkeling. Dit zijn de gangbare patronen:

  • Server-side template-injectie: het JSON-LD-blok wordt gegenereerd door de server op basis van paginadata. Meest betrouwbaar voor crawlers.
  • CMS-hooks en plugins: in WordPress genereren plugins het JSON-LD-blok automatisch op basis van veldwaarden. Geen handmatige HTML-aanpassingen nodig.
  • Build-time generatie: bij statische sitegeneratoren (zoals Next.js of Gatsby) wordt het blok tijdens de build aangemaakt en meegeleverd in de HTML.
  • Tag manager-injectie: werkt, maar alleen als je zeker weet dat Googlebot de tag manager uitvoert. Niet aanbevolen voor SEO-kritische markup.
  • Client-only JavaScript: vermijd dit voor gestructureerde data die rich results moet ondersteunen. De kans dat Googlebot de data mist is reëel.

Voor validatie gebruik je:

  • Schema Markup Validator: controleert of de markup correct is volgens schema.org-vocabulaire.
  • Rich Results Test (search.google.com/test/rich-results): toont of de pagina in aanmerking komt voor specifieke rich results.
  • Google Search Console: geeft een overzicht van gedetecteerde gestructureerde data en fouten op domeinniveau.
  • JSON-linters: controleer de syntaxis van je JSON-blok voordat je het deployt.

Pro-tip: Controleer na implementatie ook de invloed op laadtijd. Een groot JSON-LD-blok in de <head> kan render-blocking zijn als het niet goed is geplaatst. Gebruik de lazy loading-checklist om te controleren of je performance-metrics zoals LCP en CLS niet verslechteren door de toevoeging.

Hoe migreer je stap voor stap van Microdata naar JSON-LD?

Migreer gefaseerd. Verwijder werkende Microdata pas nadat JSON-LD gevalideerd is en rich results zichtbaar zijn in Search Console.

  1. Inventarisatie: breng alle pagina-types in kaart die Microdata gebruiken. Noteer per type welke itemtype en itemprop-waarden aanwezig zijn.
  2. Mapping: maak een document dat elke itemprop koppelt aan de overeenkomstige JSON-LD-property. Gebruik schema.org als referentie voor de juiste property-namen.
  3. Templating: bouw het JSON-LD-blok per pagina-type in je CMS of template-engine. Test eerst op één pagina-type.
  4. Staging-validatie: valideer het nieuwe blok met de Schema Markup Validator en de Rich Results Test voordat je live gaat.
  5. Gefaseerde uitrol: rol JSON-LD uit per pagina-type, niet in één keer over de hele site.
  6. Monitoring: volg Search Console minimaal vier weken na uitrol. Kijk naar het aantal gedetecteerde items en eventuele fouten.
  7. Verwijdering Microdata: pas nadat JSON-LD stabiel is en rich results bevestigd zijn, verwijder je de Microdata-attributen.

Tijdsinschatting per schaal:

Schaal Doorlooptijd
Kleine site (enkele pagina-types) 1–2 weken
Middelgrote CMS (meerdere pagina-types) 3–6 weken
Enterprise (veel pagina-types) 2–4 maanden

Houd een rollback-plan klaar: bewaar de Microdata-implementatie in een aparte branch of via een feature-flag totdat de JSON-LD-uitrol stabiel is bevestigd.

Pro-tip: Automatiseer de validatie van required properties in je CI-pipeline. Een test die controleert of het JSON-LD-blok de verplichte velden bevat, vangt fouten op voordat ze live gaan. Koppel dit aan Search Console-monitoring voor een volledig vangnet.

Hoe migreer je stap voor stap van Microdata naar JSON-LD? — overview diagram

Welke SEO-impact heeft gestructureerde data en welke fouten moet je vermijden?

Het formaat zelf, JSON-LD of Microdata, is geen directe rankingfactor. Wat telt is of de implementatie correct en volledig is. Correcte gestructureerde data maakt een pagina in aanmerking voor rich results, en rich results verhogen de zichtbaarheid in de zoekresultaten. Dat is het mechanisme.

Veelgemaakte fouten die rich results blokkeren:

  • Ontbrekende verplichte properties voor het gekozen schema-type.
  • Dubbele entiteiten op één pagina met tegenstrijdige waarden.
  • Beide formats (JSON-LD én Microdata) voor dezelfde entiteit op één pagina.
  • Markup die niet overeenkomt met de zichtbare inhoud van de pagina.
  • Verouderde property-namen die niet meer door schema.org worden ondersteund.

Meetpunten om bij te houden:

  1. Search Console: rapport Verbeteringen: toont fouten en waarschuwingen per schema-type.
  2. Rich Results Test: controleer na elke deployement of eligibility intact is.
  3. CTR in Search Console: vergelijk de klikfrequentie van pagina’s met en zonder rich results.
  4. Gedetecteerde items: het aantal door Google herkende gestructureerde data-items per type.

Lees voor de bredere strategische context ook de SEO-trends voor 2026 om te zien hoe gestructureerde data past binnen een complete SEO-aanpak.

Wat is de conclusie en welke stap zet je nu?

JSON-LD is de standaard voor nieuwe implementaties. Microdata houd je alleen in stand als de migratie meer kost dan het oplevert.

Drie concrete stappen voor je team:

  • Quick audit: controleer welke pagina-types gestructureerde data gebruiken en in welk formaat. Gebruik de Rich Results Test en Search Console.
  • Server-side JSON-LD implementeren: start met het pagina-type met de hoogste SEO-waarde. Valideer op staging, dan live.
  • Monitoring inrichten: stel Search Console-alerts in voor fouten in gestructureerde data en volg rich result-eligibility per type.

Pro-tip: Begin met één pagina-type, niet met de hele site. Een succesvolle pilot op bijvoorbeeld je productpagina’s geeft je het bewijs en het vertrouwen om de rest te migreren. Kleine stappen, meetbare resultaten.

Wil je dit uitbesteden? Nebber helpt je met de audit en het migratieplan. Meer daarover hieronder.

Waarom kies ik bijna altijd voor JSON-LD?

JSON-LD wint het niet omdat het technisch indrukwekkender is. Het wint omdat het onderhoudbaar is. Microdata-implementaties die ik tegenkom op bestaande sites zijn vaak gebroken zonder dat iemand het weet: een thema-update heeft een wrapper toegevoegd, een itemprop-keten is stil gesneuveld, en Search Console meldt al maanden fouten die niemand heeft opgemerkt.

Bij legacy-sites adviseer ik soms om Microdata te laten staan. Als de implementatie werkt, de site stabiel is en er geen grote templatewijzigingen gepland zijn, is migratie een investering zonder direct rendement. Dat zeg ik dan ook gewoon. Maar starten met Microdata op een nieuw project? Dat raad ik altijd af. Je bouwt een probleem in dat je later moet oplossen.

De Json-ld laat zien hoe eenvoudig het formaat is om te templaten en te valideren. Dat gemak vertaalt zich direct naar minder fouten en minder tijd kwijt aan debugging.

Wil je hulp bij de audit of migratie?

Nebber voert technische SEO-audits uit waarbij gestructureerde data een vast onderdeel is. Je krijgt een helder overzicht van wat er nu staat, wat er ontbreekt en wat de prioriteit is. Daarna volgt een concreet migratieplan per pagina-type, inclusief validatie op staging en monitoring na uitrol.

Nebber

De aanpak is altijd gefaseerd: audit, pilot op één pagina-type, dan uitrol. Geen grote bang, maar meetbare stappen. Wil je weten wat dit voor jouw site betekent? Neem contact op via Nebber en vraag een vrijblijvende intake aan.

Bronnen

Directe links naar de documentatie en testtools die je meteen kunt gebruiken:

Pro-tip: Start met een quick audit in de Rich Results Test. Voer de vijf belangrijkste pagina-types van je site in en kijk direct welke markup Google herkent en waar fouten zitten. Dat geeft je in tien minuten een helder startpunt.

Aanbeveling