Hoe ziet JSON-LD eruit?
Een schoenmakerij zet dit blok in de head van de homepage:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Schoenmakerij Example",
"url": "https://www.example.nl/",
"logo": "https://www.example.nl/logo.png"
}
</script>Met @context koppel je de korte namen in het blok aan een woordenlijst, hier schema.org. Met @type geef je aan wat voor ding je beschrijft, hier een organisatie. De andere sleutels zijn eigenschappen uit die woordenlijst: de naam, het webadres en het logo.
Omdat de gegevens in een apart blok staan, hoef je de HTML van de tekst zelf niet aan te passen. Volgens het W3C is JSON-LD volledig compatibel met JSON. Bestaande JSON-software kan het dus gewoon lezen.
Wat zegt Google over JSON-LD?
Google ondersteunt drie formaten voor gestructureerde data: JSON-LD, Microdata en RDFa. Alle drie zijn voor Google even goed, zolang de code geldig is en volgens de documentatie is gemaakt. Google raadt JSON-LD aan, omdat het voor website-eigenaren het makkelijkst te maken en te onderhouden is. Een paar aandachtspunten uit de documentatie:
- Plaats: het script-element mag in de head of in de body staan.
- Via JavaScript: Google kan JSON-LD ook lezen als een script of een widget het blok later op de pagina zet.
- Alleen zichtbare informatie: beschrijf niets wat de bezoeker niet op de pagina ziet, ook al klopt het.
Voor Google Zoeken komen de meeste eigenschappen uit schema.org. Welke eigenschappen verplicht zijn voor een uitgebreid zoekresultaat, staat in de documentatie van Google. Een JSON-LD-blok maak je zonder te programmeren met onze schema markup generator. Met de Rich Results Test controleer je of je code klopt. Wat Google met die data kan tonen, lees je bij rich snippets.
Verwar JSON-LD niet met
- JSON: het algemene tekstformaat om gegevens uit te wisselen. JSON-LD bouwt daarop voort en voegt onder meer eenduidige namen en verwijzingen naar andere bronnen toe.
- Schema.org: de woordenlijst met typen en eigenschappen, zoals Organization en name. JSON-LD is de notatie waarin je die woorden opschrijft. Meer over die woordenlijst lees je in het kennisbankartikel over schema markup.
- Microdata en RDFa: twee andere formaten voor gestructureerde data. Die zet je als attributen in de HTML-elementen van de zichtbare tekst.
Veelgestelde vragen over JSON-LD
Waar staat JSON-LD voor?
JSON-LD staat voor JSON for Linked Data. JSON is een tekstformaat om gegevens uit te wisselen. Linked Data zijn gegevens die naar andere gegevens op het web verwijzen.
Waar zet je JSON-LD op je pagina?
In een script-element met type application/ld+json. Dat mag in de head of in de body staan. Google kan het blok ook lezen als JavaScript het op de pagina zet.
Is JSON-LD beter voor SEO dan Microdata?
Voor Google zijn JSON-LD, Microdata en RDFa even goed, als de code klopt. Google raadt JSON-LD aan, omdat het makkelijker te maken en te onderhouden is.