JSON-LD in WordPress: complete gids voor implementatie en controle

JSON-LD in WordPress voeg je het veiligst toe via één centrale bron: een bestaande SEO-plugin als die de benodigde markup correct uitvoert, een gespecialiseerde schema-plugin voor specifieke pagina’s, of maatwerk voor complexe en dynamische gegevens. Kies eerst welke gegevens echt op de pagina staan, voorkom dubbele output en test iedere wijziging met Google-tools. JSON-LD kan Google helpen je inhoud te begrijpen, maar geeft geen garantie op rich results of betere posities.

Wat is JSON-LD in WordPress?

JSON-LD staat voor JavaScript Object Notation for Linked Data. Het is een formaat om gestructureerde gegevens aan een webpagina toe te voegen. Die gegevens staan doorgaans in een script-element en zijn voor bezoekers niet als gewone paginacontent zichtbaar.

In WordPress kan JSON-LD bijvoorbeeld beschrijven dat een pagina over je organisatie gaat, een artikel is, breadcrumbs bevat of een lokale vestiging beschrijft. De termen die je daarvoor gebruikt, komen meestal uit het vocabulaire van Schema.org.

Houd deze begrippen uit elkaar:

• Schema.org is het vocabulaire met typen en eigenschappen, zoals Organization, Article en name.
• Structured data is de verzamelnaam voor machineleesbare informatie op een pagina.
• JSON-LD is een formaat om die structured data technisch te publiceren.
• Rich results zijn uitgebreide zoekresultaten die Google voor bepaalde ondersteunde typen kan tonen. Correcte markup is geen garantie dat Google die weergave kiest.

Wat levert JSON-LD wel en niet op?

Goede markup maakt de inhoud en onderlinge relaties op je website duidelijker voor zoekmachines. Google ondersteunt voor specifieke zoekfuncties slechts een deel van de mogelijke schema.org-typen en eigenschappen. Bekijk daarom altijd de actuele overzichtspagina van Google-ondersteunde structured data voordat je een implementatie prioriteit geeft.

JSON-LD is geen vervanging voor heldere content, een goed werkende website of technische SEO. Markup moet overeenkomen met wat bezoekers op de pagina kunnen zien. Voeg bijvoorbeeld geen reviewscore, openingstijden, dienst of auteur toe wanneer die informatie niet op de betreffende pagina staat of niet klopt.

Structured data is één onderdeel van bredere conversie- en SEO-optimalisatie. De structuur van de pagina, interne links, inhoudelijke kwaliteit en technische bereikbaarheid blijven minstens zo belangrijk.

Wanneer is JSON-LD relevant voor een zakelijke WordPress-website?

Begin niet met zoveel mogelijk schema-types. Begin met pagina’s waarop je betrouwbare, concrete informatie publiceert en die je structureel onderhoudt. Voor veel zakelijke websites zijn organisatiegegevens, breadcrumbs en artikelmarkup logische vertrekpunten. Lokale bedrijven kunnen daarnaast beoordelen of hun zichtbare bedrijfsgegevens goed aansluiten bij LocalBusiness-markup.

Situatie op je website	Praktische markup	Waarop controleren?	Meest passende route
Algemene bedrijfswebsite met een vaste merknaam en logo	Organization en WebSite	Naam, URL en logo zijn consistent en actueel	SEO-plugin of beperkt maatwerk op siteniveau
Kennisbank met redactionele artikelen	Article of BlogPosting	Titel, afbeelding, auteur en datum komen overeen met de zichtbare pagina	SEO-plugin of maatwerk in het artikeltemplate
Website met een zichtbare broodkruimelnavigatie	BreadcrumbList	Volgorde en URL’s sluiten aan op de echte navigatie	Thema, SEO-plugin of breadcrumb-plugin
Dienstverlener met een fysieke, publiek vermelde vestiging	LocalBusiness of een passend subtype	Adres, telefoonnummer, openingstijden en bedrijfsnaam zijn zichtbaar en actueel	Schema-plugin of maatwerk na controle van bestaande output
Complexe website met custom post types, meerdere locaties of CRM-data	Type en eigenschappen afhankelijk van het contentmodel	Dynamische velden, unieke @id-waarden, canonieke URL’s en conflicten	Custom plugin of maatwerk in een child theme

JSON-LD toevoegen in WordPress: vier methodes

1. Via een SEO-plugin

Veel SEO-plugins genereren basisgegevens voor onder meer organisatie, website, breadcrumbs en artikelen. Dit is vaak de beste eerste keuze wanneer de plugin al op je site staat en de output past bij je content.

Controleer vóór je aanvullende markup toevoegt altijd eerst de broncode of een testtool. Anders voeg je mogelijk een tweede versie van dezelfde organisatie, breadcrumb of artikel toe.

2. Via een gespecialiseerde schema-plugin

Een schema-plugin kan praktisch zijn wanneer je extra typen per pagina of custom post type wilt beheren zonder code te schrijven. Kies alleen voor deze route als de plugin duidelijk maakt welke markup hij op welke pagina publiceert.

Schakel overlappende functies van andere plugins uit waar dat kan. Twee plugins die allebei Article- of Organization-markup publiceren, leveren meestal geen betere implementatie op.

3. Handmatig in een template of in de head

Handmatige JSON-LD is geschikt voor stabiele, sitebrede gegevens of voor een beperkt aantal templates. Plaats de markup bij voorkeur via een child theme of een veilige code-integratie, niet door een parent theme rechtstreeks aan te passen. Een theme-update kan handmatige wijzigingen anders overschrijven.

Gebruik deze route niet voor gegevens die per pagina sterk wisselen, tenzij je de waarden dynamisch uit WordPress-velden opbouwt.

4. Dynamisch met een custom plugin

Een custom plugin is doorgaans de robuustste keuze als je markup afhangt van custom fields, meerdere vestigingen, auteurs, diensten of interne relaties. Je houdt de logica dan los van het design van het thema en kunt wijzigingen beter testen en beheren.

Stappenplan: JSON-LD veilig implementeren

1. Inventariseer de huidige output. Test representatieve URL’s en bekijk welke structured data al aanwezig is. Noteer per type welke plugin, template of codefragment de markup vermoedelijk aanmaakt.
2. Kies een concrete gebruikers- en zoekmachinevraag. Voeg alleen markup toe die je pagina betekenisvol beschrijft. Begin bijvoorbeeld met breadcrumbs op pagina’s waar bezoekers die navigatie ook zien.
3. Leg één eigenaar per schema-type vast. Bepaal bijvoorbeeld dat de SEO-plugin organisatie- en artikelgegevens beheert, terwijl maatwerk alleen gegevens voor een specifiek custom post type toevoegt.
4. Koppel waarden aan betrouwbare WordPress-velden. Gebruik voor titel, uitgelichte afbeelding, publicatiedatum en canonieke URL de velden die ook de zichtbare pagina voeden. Voorkom handmatig gekopieerde waarden die later verouderen.
5. Maak entiteiten herkenbaar met @id. Gebruik consistente identifiers als je organisatie, website, pagina en breadcrumbrelaties aan elkaar koppelt. Laat een bestaande plugin dit doen wanneer die structuur al correct is.
6. Publiceer eerst op een testomgeving of beperkte set URL’s. Wis daarna relevante caches. Cachelagen kunnen anders oude markup tonen, terwijl je in WordPress al een wijziging hebt opgeslagen.
7. Valideer de markup én de pagina. Test de URL in Rich Results Test waar het type daarvoor in aanmerking komt. Controleer ook of de gepubliceerde pagina bereikbaar is, de juiste canonieke URL heeft en dezelfde feiten toont als de markup.
8. Monitor na livegang. Gebruik Google Search Console om eventuele structured-data-meldingen op te volgen. Herhaal controles na wijzigingen aan content, thema, plugins, URL’s en templates.

Een veilige basisstructuur opbouwen

JSON-LD begint meestal met @context en @type. Met @id kun je een entiteit consistent identificeren. Onderstaand voorbeeld is bewust beperkt. Vervang geen waarden zonder te controleren dat ze op de website zichtbaar en correct zijn.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://voorbeeld.nl/#organization",
  "name": "Bedrijfsnaam",
  "url": "https://voorbeeld.nl/"
}

Gebruik een voorbeeld niet als kopieerrecept. Een organisatie met meerdere locaties, handelsnamen of specifieke bedrijfstypen vraagt mogelijk om een andere modellering. Voeg ook niet op basis van een template eigenschappen toe die je niet kunt onderbouwen op de pagina.

Welke schema-types passen vaak bij WordPress?

Organization en WebSite

Deze typen zijn bruikbaar voor de basisidentiteit van een organisatie en website. Zorg vooral dat naam, URL en eventuele logo-informatie overal consistent zijn. Maak niet meerdere strijdige organisatie-entiteiten aan via thema, SEO-plugin en schema-plugin.

BreadcrumbList

Breadcrumbs helpen gebruikers navigeren. Als je breadcrumbs op de pagina toont, kan passende markup de hiërarchie ook machineleesbaar maken. Controleer dat de items overeenkomen met de werkelijk zichtbare broodkruimels en geen URL’s bevatten die inmiddels zijn verplaatst of verwijderd. Heb je URL-wijzigingen gehad, controleer dan ook je redirects en los eventuele 404- en soft-404-fouten op.

Article en BlogPosting

Voor redactionele kennisbankartikelen kunnen Article en BlogPosting passend zijn. Google documenteert de relevante eigenschappen en validatie voor dit type in de richtlijn voor Article structured data. Laat titel, afbeelding, auteur en datums altijd aansluiten op de zichtbare artikelpagina.

LocalBusiness

LocalBusiness-markup past alleen wanneer een pagina werkelijk over een lokaal bedrijf of een publiek gepresenteerde locatie gaat. Gebruik actuele, zichtbare gegevens en kies een specifieker subtype alleen als het daadwerkelijk past bij je onderneming. Voeg niet zonder reden vestigingen, servicegebieden of openingstijden toe.

Dubbele schema markup herkennen en voorkomen

Dubbele markup ontstaat vaak nadat een nieuwe plugin is geïnstalleerd of wanneer een thema naast een SEO-plugin eigen structured data uitvoert. Twee identieke objecten zijn niet automatisch schadelijk, maar dubbele of tegenstrijdige gegevens maken onderhoud en foutopsporing lastiger.

• Zoek in de paginabron naar application/ld+json en vergelijk de blokken.
• Controleer of Organization, WebSite, Article en BreadcrumbList meerdere keren voorkomen.
• Vergelijk namen, URL’s, datums, afbeeldingen en @id-waarden.
• Schakel de overlappende module uit of verwijder het maatwerk dat niet langer nodig is.
• Test opnieuw na het legen van caching en optimalisatieplugins.

JSON-LD testen: wat controleer je precies?

De Rich Results Test is nuttig om te controleren of Google markup voor ondersteunde rich-result-typen kan lezen. Een geldige test betekent echter niet dat je pagina rich results krijgt. Google bepaalt zelf of een uitgebreide weergave geschikt is.

Controleer daarnaast via URL Inspection in Search Console of Google de actuele, bereikbare URL kan inspecteren. In Search Console kun je vervolgens meldingen bekijken voor relevante structured-data-typen. Los fouten op, maar beoordeel waarschuwingen in de context van het type en de pagina: niet iedere optionele eigenschap is noodzakelijk of relevant.

Google benadrukt in zijn algemene richtlijnen voor structured data onder meer dat markup de zichtbare inhoud moet vertegenwoordigen, dat pagina’s toegankelijk moeten zijn voor Google en dat correcte markup geen weergavegarantie biedt.

Veelvoorkomende fouten en oplossingen

De markup bevat informatie die bezoekers niet zien Pas de content of de markup aan. Structured data mag geen verborgen uitbreiding zijn van je aanbod, beoordelingen of bedrijfsgegevens. Na een pluginupdate verschijnen fouten Vergelijk de output vóór en na de update op een testomgeving. Controleer of instellingen, custom fields of template-hooks zijn gewijzigd. Een artikel toont de verkeerde datum of afbeelding Controleer welk WordPress-veld de markup gebruikt. Laat de markup bij voorkeur dezelfde bron gebruiken als de zichtbare titel, afbeelding en datum. Google meldt dubbele of tegenstrijdige gegevens Vind de twee bronnen van output en wijs per type één bron aan. Verwijder of schakel de andere implementatie uit. De test is geldig, maar er verschijnt geen rich result Dat is mogelijk. Controleer of het type door Google wordt ondersteund en of de pagina aan de richtlijnen voldoet, maar presenteer rich results niet als een gegarandeerd effect.

Onderhoud: wanneer opnieuw controleren?

Controleer JSON-LD opnieuw na wijzigingen aan je thema, SEO-plugin, schema-plugin, caching, permalinkstructuur, redirects, custom fields en belangrijke templates. Doe hetzelfde bij een wijziging in bedrijfsnaam, vestigingsgegevens, auteursinformatie of artikeltemplates.

Neem structured data op in je technische onderhoudsroutine. Dat sluit aan bij een bredere aanpak waarin content, techniek en conversie samenkomen. Bekijk ook de diensten van LYNX Media als je ondersteuning zoekt bij websiteontwikkeling, SEO of optimalisatie.

Praktische eindcheck voor publicatie

• De markup beschrijft uitsluitend zichtbare, actuele pagina-inhoud.
• Er is per schema-type één duidelijke bron van output.
• Titels, datums, afbeeldingen, URL’s en bedrijfsgegevens komen overeen met de pagina.
• De canonieke URL en interne navigatie verwijzen naar de juiste pagina.
• Cache is geleegd en de live broncode bevat de verwachte JSON-LD.
• De URL is getest met de geschikte Google-tool.
• Fouten en onverwachte duplicaten zijn opgelost voordat je verder uitrolt.

Wanneer is maatwerk verstandig?

Schakel maatwerk of een technische SEO-audit in wanneer je custom post types, meerdere vestigingen, complexe contentrelaties, migraties of terugkerende structured-datafouten hebt. Dat geldt ook wanneer je pluginoutput niet aansluit op je zichtbare content of wanneer meerdere systemen dezelfde gegevens publiceren. Een goede implementatie is niet zo uitgebreid mogelijk, maar consistent, onderhoudbaar en aantoonbaar passend bij je website.

Bespreek je website of online groeikansen met LYNX Media.