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.

Beste schema eerst Article, WebPage en BreadcrumbList voor de meeste gids-pagina's.
Beste workflow Genereer schema vanuit dezelfde paginametadata die titel, beschrijving, canoniek en Open Graph aandrijft.
Beste realiteitscheck FAQPage- en WebSite-markup kunnen nog steeds inhoud beschrijven, maar bouw geen strategie rond verouderde Google-weergaven.

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.

Belangrijk: Gestructureerde data moet de pagina ondersteunen, niet nuttige inhoud vervangen. Als de zichtbare pagina dun, verwarrend, verouderd of misleidend is, maakt schema markup er geen sterke zoekresultaat van.

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.

01

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.

02

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.

03

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.

04

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.

05

Houd data eerlijk

Wijzig dateModified alleen bij betekenisvolle inhoudswijzigingen. Vernieuw data niet automatisch alleen om er nieuwer uit te zien in zoekresultaten.

06

Maak afbeeldingen crawlbaar

Gebruik absolute afbeeldings-URL's, geschikte afmetingen en bestanden die niet worden geblokkeerd door robots, authenticatie of alleen lazy-loading rendering.

07

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.

08

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.

HTMLVoorbeeld van Article JSON-LD
<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>
C#C# helperpatroon
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>");
}
Praktische regel: Gebruik stabiele URL's voor url en @id. Gebruik overal dezelfde canonieke URL. Als dezelfde pagina onder meerdere taal-URL's verschijnt, genereer dan taal-specifieke metadata en houd elke hreflang/canonieke instelling consistent.

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 Test

Vocabulaire

Schema Markup Validator

Controleert algemene schema.org-structuur en JSON-LD-syntaxis, inclusief types, eigenschappen, geneste entiteiten en foutieve JSON.

Open Schema Markup Validator

Veelvoorkomende 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

De bovenstaande richtlijnen zijn gebaseerd op officiële Google Search Central- en schema.org-documentatie, en omgezet in een praktische JSON-LD-checklist.

01 Introductie Google gestructureerde data developers.google.com 02 Google beleid voor gestructureerde data developers.google.com 03 Google Article gestructureerde data developers.google.com 04 Google Breadcrumb gestructureerde data developers.google.com 05 Google FAQ gestructureerde data developers.google.com 06 Google sitelinks zoekvak update developers.google.com 07 Schema.org aan de slag schema.org 08 Google Rich Results Test search.google.com 09 Schema Markup Validator validator.schema.org

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.