Praktische gids voor gestructureerde data
JSON-LD Schema Markup Gids voor Praktische SEO
JSON-LD helpt zoekmachines te begrijpen wat een pagina is, wie het publiceerde, hoe het in uw site past en welke feiten bruikbaar zijn voor ondersteunde zoekfuncties.
Het nuttige doel is niet om elk schema-type toe te voegen dat u kunt vinden. Het doel is nauwkeurige gestructureerde data die overeenkomt met de zichtbare pagina, schoon valideert en synchroon blijft bij inhoudswijzigingen.
De handige korte versie
Gebruik JSON-LD als u de pagina kunt beschrijven met eerlijke, zichtbare feiten: titel, beschrijving, auteur, publicatiedatum, breadcrumbs, productdetails, videogegevens of duidelijke vraag-en-antwoordinhoud. Voeg geen schema toe om functies te beloven die Google niet meer toont of om inhoud te markeren die gebruikers niet kunnen zien.
Inhoudsopgave
Wat JSON-LD eigenlijk doet
JSON-LD is een machineleesbaar blok gestructureerde data. Het staat meestal in een script-tag in de head of body van de pagina en beschrijft entiteiten met schema.org-woordenlijst. Zoekmachines gebruiken het als een verduidelijkingslaag bovenop de zichtbare inhoud.
Parserduidelijkheid
Betekenis
Het zet paginafeiten om in benoemde entiteiten en eigenschappen, zoals Article, auteur, datePublished, BreadcrumbList of SoftwareApplication.
Zoekfunctie
Geschiktheid
Het kan een pagina in aanmerking laten komen voor ondersteunde rich results, maar Google bepaalt nog steeds wat wordt getoond op basis van kwaliteit, beleid, zoekopdracht en beschikbaarheid van functies.
Sitegrafiek
Consistentie
Het geeft uw CMS of Blazor-app één gestructureerde plek om dezelfde canonieke URL, taal, titel, data, afbeeldingen en uitgeversgegevens te hergebruiken.
Geen snelkoppeling
Limiet
Het repareert geen zwakke inhoud, nepbeoordelingen, verborgen FAQ-antwoorden, verouderde data of pagina's die niet overeenkomen met de gestructureerde data.
Kies schema op basis van het doel van de pagina
De makkelijkste manier om spammy of dubbele gestructureerde data te vermijden is te vragen wat de pagina probeert te doen. Voeg de kleinste schema-set toe die die taak nauwkeurig beschrijft.
Inhoud
Article / BlogPosting
- Gebruik het voor
- Gidsen, tutorials, reviews, nieuwsberichten en uitgebreide uitleg.
- Toevoegen wanneer
- De pagina heeft een duidelijke kop, auteur of uitgever, publicatiedatum, wijzigingsdatum, canonieke URL en afbeelding.
- Vermijden wanneer
- De pagina is meestal een tool-UI, productlijst, categoriepagina of dunne landingspagina.
Navigatie
BreadcrumbList
- Gebruik het voor
- Bijna elke pagina onder de homepage.
- Toevoegen wanneer
- Gebruikers kunnen begrijpen waar de pagina zich in de sitehiërarchie bevindt.
- Vermijden wanneer
- Het breadcrumb-pad komt niet overeen met interne links, canonieke URL's of zichtbare navigatie.
Site-identiteit
WebPage / WebSite / Organization
- Gebruik het voor
- Homepage, hubs, over-pagina's en pagina's waar uitgeversidentiteit belangrijk is.
- Toevoegen wanneer
- U wilt een stabiele entiteitengrafiek die de pagina, site, uitgever en taal met elkaar verbindt.
- Vermijden wanneer
- U voegt WebSite-markup alleen toe om de oude sitelinks-zoekvakweergave na te jagen.
Product of app
Product / SoftwareApplication
- Gebruik het voor
- Tools, apps, SaaS-pagina's, extensies, downloadbare software of echte productpagina's.
- Toevoegen wanneer
- Zichtbare paginainhoud omvat naam, beschrijving, besturingssysteem of categorie, prijs, aanbiedingen en beoordelingen wanneer u deze markeert.
- Vermijden wanneer
- Beoordelingen, prijs, beschikbaarheid of reviews zijn niet zichtbaar voor gebruikers op de pagina.
Vragen
FAQPage
- Gebruik het voor
- Zichtbare vraag-en-antwoordsecties die gebruikers echt helpen het onderwerp te begrijpen.
- Toevoegen wanneer
- De Q&A-inhoud is nuttig op de pagina, ook al toont Google geen FAQ-rich results.
- Vermijden wanneer
- U voegt generieke Q&A alleen toe om zoekruimte in te nemen of hetzelfde antwoord op veel pagina's te herhalen.
Media
VideoObject / ImageObject
- Gebruik het voor
- Pagina's met een belangrijke ingesloten video, tutorialvideo of crawlbare afbeelding.
- Toevoegen wanneer
- De media staat centraal op de pagina en heeft titel, beschrijving, thumbnail, uploaddatum en een stabiele URL.
- Vermijden wanneer
- De media is decoratief, verborgen, geblokkeerd of niet relevant voor het hoofddoel van de pagina.
Implementatiechecklist die de meeste fouten voorkomt
Goede JSON-LD is op de beste manier saai: consistent, gegenereerd uit betrouwbare velden, makkelijk te valideren en moeilijk te vergeten bij paginawijzigingen.
Kies één hoofdentiteit van de pagina
Bepaal of de pagina vooral een artikel, product, app, video, FAQ, collectie of generieke webpagina is. Secundair schema moet die hoofdentiteit ondersteunen.
Kom overeen met zichtbare inhoud
Elke gemarkeerde claim moet zichtbaar of duidelijk afleidbaar zijn op de pagina: titel, auteur, data, prijs, beoordeling, Q&A, breadcrumbs en afbeeldingen.
Gebruik stabiele @id-waarden
Geef belangrijke entiteiten stabiele ID's zoals de canonieke URL plus #article, #webpage, #organization of #faq. Dit helpt parsers om grafiekstukken te verbinden.
Genereren vanuit gedeelde metadata
Herbruik dezelfde bronvelden die titel-tags, meta-beschrijvingen, canonieke URL's, Open Graph-afbeeldingen, taal-tags en laatst gewijzigde data creëren.
Houd data eerlijk
Wijzig dateModified alleen bij betekenisvolle inhoudswijzigingen. Vernieuw data niet automatisch alleen om er nieuwer uit te zien in zoekresultaten.
Maak afbeeldingen crawlbaar
Gebruik absolute afbeeldings-URL's, geschikte afmetingen en bestanden die niet worden geblokkeerd door robots, authenticatie of alleen lazy-loading rendering.
Vroeg renderen
In Blazor en andere JavaScript-apps heeft prerendered of server-rendered JSON-LD de voorkeur zodat crawlers het in de initiële HTML-respons zien.
Valideer en monitor
Voer de Rich Results Test uit voor publicatie, controleer de Schema Markup Validator op syntaxis en houd Search Console in de gaten na indexering.
Een helder JSON-LD-patroon voor Blazor-pagina's
Voor Blazor is het veiligste patroon om schema te bouwen vanuit paginametadata tijdens initialisatie of prerendering, het één keer te serialiseren en het application/ld+json-script te renderen waar crawlers het in de initiële HTML kunnen zien.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"@id": "https://example.com/en/json-ld-schema-guide/#article",
"headline": "JSON-LD Schema Markup Guide for Practical SEO",
"description": "A practical guide to choosing, generating, and validating structured data.",
"image": "https://example.com/images/json-ld-guide.png",
"datePublished": "2026-03-28T10:00:00+00:00",
"dateModified": "2026-05-31T10:00:00+00:00",
"author": {
"@type": "Organization",
"name": "Example Publisher"
},
"publisher": {
"@type": "Organization",
"name": "Example Publisher",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/en/json-ld-schema-guide/"
}
}
</script>private MarkupString BuildJsonLd(PageMetaData meta)
{
var pageUrl = BuildPageUrl(meta);
var schema = new Dictionary<string, object?>
{
["@context"] = "https://schema.org",
["@type"] = "Article",
["@id"] = $"{pageUrl}#article",
["headline"] = meta.Title,
["description"] = meta.Description,
["url"] = pageUrl,
["datePublished"] = meta.Published?.ToString("O"),
["dateModified"] = meta.Modified?.ToString("O"),
["inLanguage"] = CS.Culture
};
var json = JsonSerializer.Serialize(schema, new JsonSerializerOptions
{
DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull
});
return new MarkupString($"<script type=\"application/ld+json\">{json}</script>");
}Valideer JSON-LD voordat u erop vertrouwt
Validatie heeft twee verschillende taken. De Schema Markup Validator controleert of het vocabulaire en de JSON-LD-syntaxis begrijpelijk zijn. Google's Rich Results Test controleert of Google de pagina herkent als geschikt voor ondersteunde rich result-types.
Google geschiktheid
Rich Results Test
Controleert of Google de pagina kan lezen en of gedetecteerde gestructureerde data in aanmerking komt voor ondersteunde rich result-types.
Open Rich Results TestVocabulaire
Schema Markup Validator
Controleert algemene schema.org-structuur en JSON-LD-syntaxis, inclusief types, eigenschappen, geneste entiteiten en foutieve JSON.
Open Schema Markup ValidatorNa publicatie
Search Console
Gebruik URL Inspection en Enhancement-rapporten om crawl-, indexerings- en gestructureerde data-problemen te detecteren nadat Google de pagina heeft verwerkt.
Lees Google-documentatie over gestructureerde dataVeelvoorkomende JSON-LD-fouten die vertrouwen schaden
De meeste schema-problemen zijn geen complexe technische fouten. Het zijn inconsistenties tussen wat de markup zegt en wat de gebruiker of crawler op de pagina kan verifiëren.
Markup van verborgen of ontbrekende inhoud
Als gebruikers het antwoord, review, aanbod, afbeelding of auteurclaim niet kunnen zien, zet het dan niet in gestructureerde data. Dit is de snelste manier om vertrouwen te verliezen.
FAQPage overal toevoegen
FAQ-schema kan nog steeds zichtbare Q&A beschrijven, maar het mag geen copy-pasteblok zijn op elke pagina. Gebruik het alleen als de Q&A de pagina verbetert.
Tegenstrijdige dubbele scripts
Meerdere Article-blokken met verschillende koppen, data of URL's maken de pagina moeilijker te interpreteren. Eén duidelijke grafiek is beter dan drie gedeeltelijke.
Verkeerde canonieke URL of @id
Schema-URL's moeten overeenkomen met de canonieke pagina, cultuur-URL en hreflang-instelling. Gemengde taal-URL's veroorzaken duplicate content en entiteitsverwarring.
Nepversheid
Verander dateModified niet voor sjabloonwijzigingen, trackingwijzigingen of alleen schema-updates. Gebruik de datum voor echte inhoudswijzigingen.
Alleen client late rendering
Als JSON-LD pas na vertraagde client-rendering verschijnt, kunnen crawlers het missen. Geef de voorkeur aan server-rendering of prerendering voor belangrijke pagina's.
Praktische schema-recepten per paginatype
U heeft zelden een gigantische grafiek nodig. Deze combinaties dekken de pagina's die de meeste kleine sites, blogs, tools en reviewprojecten daadwerkelijk publiceren.
Gidsartikel
Article + BreadcrumbList + WebPage
- Gebruik Article voor kop, auteur, uitgever, afbeelding, data en sectienamen.
- Gebruik BreadcrumbList voor het zichtbare sitepad.
- Gebruik WebPage- of @id-verwijzingen om de pagina en artikelentiteit te verbinden.
Toolpagina
SoftwareApplication + WebPage + BreadcrumbList
- Gebruik SoftwareApplication alleen als de pagina over een echte app of tool gaat.
- Voeg besturingssysteem, categorie, prijs of aanboddetails alleen toe als ze zichtbaar zijn.
- Vermijd review- of beoordelingsmarkup tenzij de pagina echte reviewgegevens toont.
Reviewpagina
Review / Product alleen als de pagina het ondersteunt
- Markeer het beoordeelde item, auteur, datum en beoordeling alleen als de pagina deze duidelijk toont.
- Houd affiliate-links en commerciële context transparant.
- Gebruik dezelfde score in schema en zichtbare inhoud.
Vraagpagina
FAQPage alleen voor nuttige zichtbare Q&A
- Maak elk antwoord op zichzelf nuttig, niet alleen een variatie op een zoekwoord.
- Verberg antwoorden niet achter geblokkeerde UI die crawlers niet kunnen bereiken.
- Verwacht geen FAQ-rich results als het belangrijkste SEO-voordeel.
Bronnen gecontroleerd
Onderzoeksbronnen voor deze gids
De bovenstaande richtlijnen zijn gebaseerd op officiële Google Search Central- en schema.org-documentatie, en omgezet in een praktische JSON-LD-checklist.
Veelgestelde vragen
Is JSON-LD schema markup een rankingfactor?
JSON-LD is geen magische rankingknop. Het helpt zoekmachines om geschikte inhoud te begrijpen en kan rich result-geschiktheid ondersteunen, maar rankings hangen nog steeds af van inhoudskwaliteit, relevantie, crawlbaarheid, links en vele andere signalen.
Waar moet JSON-LD op een pagina staan?
Een script-tag in de head is meestal het makkelijkst te beheren, maar Google kan ook JSON-LD in de body lezen. Het belangrijkste is dat de markup aanwezig is in de gerenderde pagina en overeenkomt met de zichtbare inhoud.
Moet ik nog steeds FAQPage-schema gebruiken?
Gebruik FAQPage alleen als de pagina echt nuttige zichtbare vragen en antwoorden heeft. Vertrouw er niet op voor extra Google-resultaatruimte, want de weergave van FAQ-rich results is sterk verminderd en verouderd voor de meeste reguliere sites.
Kan één pagina meerdere JSON-LD-blokken bevatten?
Ja. Een normale artikelpagina kan Article-, BreadcrumbList- en WebPage-gegevens bevatten. Houd de blokken consistent, vermijd dubbele conflicterende entiteiten en gebruik stabiele @id-waarden om gerelateerde onderdelen te verbinden.
Is JSON-LD beter dan Microdata?
Voor de meeste moderne sites wel. Google ondersteunt JSON-LD, Microdata en RDFa, maar JSON-LD is meestal makkelijker te onderhouden omdat het geen schema-attributen in visuele HTML-sjablonen vereist.
Hoe vaak moet ik gestructureerde data valideren?
Valideer telkens wanneer u sjablonen, metadata-velden, schema-helpers, URL's, taalroutering, afbeeldingsgeneratie, reviewgegevens of FAQ-secties wijzigt. Controleer ook Search Console nadat belangrijke pagina's zijn geïndexeerd.