JSON-LD implementeren: het format dat AI-systemen verkiezen

AI-crawlers geven de voorkeur aan JSON-LD boven andere schemaformats. Leer hoe je JSON-LD implementeert, waar je het plaatst en waarom het AI-citaties helpt.

Schema markup vertelt machines wat je content betekent. Maar het format dat je gebruikt maakt uit. Je kunt schema markup in drie verschillende talen schrijven: Microdata, RDFa en JSON-LD. Het grootste deel van het web gebruikt Microdata, omdat het oud en makkelijk is. AI-systemen verkiezen JSON-LD, omdat het schoon, gestructureerd en ondubbelzinnig is.

JSON-LD staat voor JSON for Linking Data. Het is een format dat speciaal is bedacht om gestructureerde data leesbaar te maken voor machines, zonder je HTML te vervuilen. Je schrijft het in een aparte script-tag. Je zichtbare content blijft schoon. De machineleesbare data staat in een eigen blok. AI-crawlers lezen JSON-LD sneller en betrouwbaarder dan andere formats. Wil je dat AI-systemen je content kunnen citeren, dan maak je dat mogelijk met JSON-LD.

Waarom JSON-LD wint van andere schemaformats

Microdata ziet er zo uit. Je voegt attributen direct toe aan je HTML-tags:

<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>

Het werkt. Google leest het. Maar je HTML raakt vol met schema-attributen. De content en de metadata zitten door elkaar verward.

JSON-LD scheidt ze helemaal:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>

Je HTML blijft schoon. De machineleesbare data staat in een eigen script-tag. AI-crawlers verkiezen deze scheiding. Ze is duidelijker. Er zijn minder snel fouten. Ze wordt sneller gelezen.

RDFa is een derde format, maar wordt zelden gebruikt. Het is ingewikkelder dan zowel Microdata als JSON-LD. Noch Google noch AI-systemen verkiezen het. Sla RDFa over.

Hoe AI-systemen JSON-LD lezen

Bezoekt een AI-crawler je pagina, dan doet die twee dingen. Hij leest je zichtbare HTML-content. En hij leest alle JSON-LD-script-tags die hij vindt.

De JSON-LD vertelt hem: deze pagina is een Article. Ze is op deze datum gepubliceerd. Ze is geschreven door deze auteur. Het hoofdonderwerp is dit. Er staat een afbeelding op deze URL. Het aantal woorden is dit. Al die metadata helpt het AI-systeem de content dieper te begrijpen dan het uit de tekst alleen zou kunnen.

Beslist het AI-systeem later of het je citeert, dan gebruikt het die metadata. Een correct opgemaakt JSON-LD-Article-schema met een publicatiedatum, auteur en afbeelding wordt vaker geciteerd dan dezelfde content zonder enig schema. De metadata bewijst dat jij de oorspronkelijke bron bent.

De essentiële structuur van JSON-LD

Elk JSON-LD-blok heeft drie kernonderdelen. De @context vertelt de parser welk vocabulaire je gebruikt (bijna altijd schema.org). Het @type vertelt wat voor soort ding je beschrijft. De eigenschappen beschrijven de specifieke kenmerken.

Een eenvoudig Article-schema ziet er zo uit:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Your article summary",
"image": "https://yoursite.com/image.jpg",
"datePublished": "2026-04-17",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Brand",
"logo": {
"@type": "ImageObject",
"url": "https://yoursite.com/logo.jpg"
}
}
}
</script>

Dat JSON-LD-blok staat in de head van je pagina (of ergens in de body). Het vertelt de crawler alles wat hij over het artikel moet weten.

Waar je JSON-LD op je pagina plaatst

De beste werkwijze is JSON-LD in het head-gedeelte van je HTML te plaatsen, boven de zichtbare content. De crawler leest eerst de head, dus hij krijgt de schema-metadata nog voordat hij begint met het lezen van de body.

Maar JSON-LD werkt overal op de pagina. In de head. In de body. Voor de content. Na de content. Het maakt niet uit. Zolang de JSON geldig is, vinden en lezen crawlers het.

Veel contentplatforms zetten JSON-LD automatisch in de head als je metadatavelden invult. Je schrijft een kop, beschrijving en publicatiedatum in je CMS. Het platform genereert de JSON-LD automatisch. Je schrijft het niet met de hand.

JSON-LD voor verschillende soorten content

Article is het meest voorkomende schematype, maar JSON-LD ondersteunt veel typen. Elk type heeft andere verplichte en optionele eigenschappen.

FAQPage-schema

Heeft je pagina een sectie met veelgestelde vragen, gebruik dan FAQPage-schema. Het vertelt AI-crawlers precies waar je vragen en antwoorden staan:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "JSON-LD is a structured data format that AI systems prefer."
}
},
{
"@type": "Question",
"name": "Where do I put JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In the head or body of your HTML page."
}
}
]
}
</script>

FAQPage-schema vergroot de kans dat AI-systemen je vragen en antwoorden juist overnemen.

Product-schema

Gebruik voor e-commerce Product-schema:

<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Product Name",
"description": "Product description",
"image": "https://yoursite.com/product.jpg",
"brand": {
"@type": "Brand",
"name": "Your Brand"
},
"offers": {
"@type": "Offer",
"url": "https://yoursite.com/product",
"priceCurrency": "USD",
"price": "99.99"
}
}
</script>

Product-schema vertelt AI-shoppingagents de exacte prijs, beschikbaarheid en kenmerken van je product.

HowTo-schema

Gebruik voor stapsgewijze gidsen HowTo-schema:

<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Set Up JSON-LD",
"step": [
{
"@type": "HowToStep",
"name": "Step 1",
"text": "Add a script tag to your page head."
},
{
"@type": "HowToStep",
"name": "Step 2",
"text": "Write valid JSON inside the script tag."
}
]
}
</script>

HowTo-schema helpt AI-systemen de volgorde te begrijpen en de stappen in de juiste volgorde over te nemen.

Veelgemaakte fouten met JSON-LD

De meest voorkomende fout is ongeldige JSON. JSON heeft strikte syntaxisregels. Elke tekenreeks moet tussen dubbele aanhalingstekens staan. Na elke eigenschap moet een dubbele punt komen. Elk object of arrayitem moet met een komma worden gescheiden. Mis je één komma, dan breekt de hele JSON.

Test je JSON voordat je live gaat. Gebruik een JSON-validator. Plak je JSON-LD in de validator en die vertelt je of er syntaxisfouten zijn.

De tweede fout is het verkeerde @type gebruiken. Is je pagina een blogbericht, gebruik dan Article, niet BlogPosting. Is het een product, gebruik dan Product, niet Item. Het type is belangrijk, omdat crawlers de structuur anders begrijpen afhankelijk van het type.

De derde fout is ontbrekende verplichte eigenschappen. Article-schema vraagt om een headline. Product-schema vraagt om een prijs. HowTo vraagt om minstens één stap. Bekijk de documentatie van schema.org per type om te zien wat verplicht en wat optioneel is.

Je JSON-LD valideren en testen

Google heeft een Rich Results Test. Je plakt je URL en de tool laat alle JSON-LD zien die hij op die pagina vond. Hij vertelt of de JSON geldig is. Hij vertelt of er verplichte eigenschappen ontbreken. Hij laat zien hoe de uitgelezen data eruitziet.

Ook schema.org heeft een validatietool. Plak je JSON-LD en die valideert de syntaxis en of het schema klopt.

De meeste CMS-platforms hebben ingebouwde validatie. Publiceer je content met ontbrekende verplichte schema-eigenschappen, dan waarschuwt het CMS je voordat je publiceert.

Veelgestelde vragen

Heb ik JSON-LD nodig als ik al Microdata gebruik?

Nee. Gebruik het ene format of het andere, niet allebei. Gebruik je Microdata en werkt dat, houd het dan. Zet je schema markup van nul op, dan is JSON-LD de betere keuze. Het is schoner, makkelijker te onderhouden en AI-systemen verkiezen het. Met de websitebouwer van WEMASY zet je dit direct op je eigen website op.

Kan ik meerdere JSON-LD-blokken op dezelfde pagina hebben?

Ja. Je kunt een Article-schema in het ene blok hebben en een Organization-schema in een ander blok. Je kunt schema's ook nesten. Een Article-schema kan bijvoorbeeld een Person-schema voor de auteur bevatten. Meerdere blokken zijn prima, zolang elk blok geldige JSON is.

Beïnvloedt JSON-LD de snelheid van mijn site?

Nee. JSON-LD is gewoon tekst. Je server hoeft er niets mee te doen. De crawler leest het als hij langskomt. Er is geen effect op de prestaties van je website. Het is onzichtbaar voor je bezoekers.

Wat als ik de content bijwerk maar vergeet de JSON-LD bij te werken?

AI-crawlers lezen de oude JSON-LD-metadata en je actuele zichtbare content. Ze merken mogelijk het verschil op. De headline in je JSON-LD moet overeenkomen met je zichtbare kop. De publicatiedatum moet kloppen. Wijken ze sterk af, dan vertrouwen crawlers mogelijk de zichtbare content boven de metadata.

Moet ik JSON-LD gebruiken voor interne links of alleen voor hoofdcontent?

Gebruik JSON-LD voor alle content die AI-systemen diep moeten begrijpen. Hoofdartikelen hebben er het meeste baat bij. Productpagina's ook. Pagina's met veelgestelde vragen ook. Eenvoudige navigatielinks hebben geen JSON-LD nodig. Richt je inspanning op content die door AI-systemen kan worden geciteerd of aanbevolen.

Kunnen AI-systemen JSON-LD zien die met CSS display:none is verborgen?

Ja. AI-crawlers lezen JSON-LD, ongeacht of het zichtbaar is voor gebruikers. Je hoeft het niet te verbergen of te tonen. De meeste platforms zetten JSON-LD in de head, waar het toch al niet zichtbaar is. De crawler ziet het. Dat is wat telt.

Zet het meteen
in je eigen website.

Start gratis met WEMASY en bouw je site in een paar minuten.