JSON-LD-gestructureerde gegevens op een webpagina controleren
Controleer JSON-LD op een webpagina op fouten en ontbrekende velden, bekijk elk schema.org-item dat erin wordt beschreven en lees de JSON van elk blok.
3 min leestijd
Om de JSON-LD op een webpagina te controleren, open je de JSON-LD Validator, plak je het pagina-adres en klik je op "JSON-LD ophalen en valideren". Het resultaat toont elk probleem, elk item dat op de pagina wordt beschreven en de JSON van elk blok. Als de pagina geen problemen heeft, is de samenvatting groen.
Een pagina controleren
- Open de pagina in je browser en kopieer het adres uit de adresbalk.
- Plak het in het URL-veld. Als het adres geen
https://bevat, wordt dit voor je toegevoegd. - Klik op "JSON-LD ophalen en valideren".
- Lees de samenvatting boven de tabellen. Daarin staat het aantal blokken, fouten en waarschuwingen.
- Kies een blok onder Bron om de JSON met regelnummers te bekijken.
Het resultaat lezen
- De problementabel toont elke fout en waarschuwing. Deze verschijnt alleen als er een probleem is.
- Blok is het nummer van het scriptblok, geteld vanaf de bovenkant van de pagina.
- Locatie toont waar het probleem zich voordoet, zoals
Product.image. - De itemtabel toont elk item, met het type, zoals Article of Product, en de naam.
- Klik op een kolomkop om een tabel te sorteren. Met de knoppen onder elke tabel exporteer je deze als CSV of JSON.
Welke problemen je het eerst oplost
Fouten staan bovenaan de lijst en hebben een rood label. Waarschuwingen hebben een geel label. Een fout betekent dat er iets kapot is of dat een verplicht veld ontbreekt. Waarschuwingen met "(optioneel)" verwijzen naar velden die je kunt toevoegen als je de gegevens hebt.
Deze meldingen zijn eenvoudig op te lossen.
| Melding | Oplossing |
|---|---|
| Ongeldige JSON | Zoek naar een ontbrekende komma of aanhalingsteken, of een komma na de laatste waarde. |
@context ontbreekt; voeg "@context": "https://schema.org" toe |
Voeg deze regel toe aan het blok. |
| @type ontbreekt | Voeg een type toe, zoals "@type": "Product". |
| "@Type" is geen JSON-LD-sleutelwoord | Schrijf sleutelwoorden in kleine letters: @type. |
| Het type "Organisation" is geen geldig schema.org-type | Gebruik de exacte naam van schema.org, hier Organization. |
| Het verplichte kenmerk "image" ontbreekt | Voeg het veld toe dat in de melding wordt genoemd. |
Als de controle niets vindt of mislukt
"Er zijn geen JSON-LD-scriptblokken gevonden op deze pagina" betekent dat de HTML van de pagina geen JSON-LD bevat. De controle leest de pagina zoals de server deze verzendt. JSON-LD die een script later in de browser toevoegt, wordt niet gevonden.
"De pagina kon niet worden opgehaald" betekent dat de site de pagina niet heeft verzonden. Dit gebeurt ook wanneer het adres doorverwijst naar een ander adres, omdat doorverwijzingen niet worden gevolgd. Kopieer het uiteindelijke adres uit de adresbalk en probeer het opnieuw.
Alleen de eerste 3 MB van een pagina worden gecontroleerd. Je krijgt een melding als een pagina groter is.
Los de fouten op, werk de pagina bij en voer de controle opnieuw uit.
Klaar om het zelf te proberen?
JSON-LD-validator
Voer een URL in. De server haalt de pagina op, extraheert elk JSON-LD-blok met gestructureerde gegevens en controleert het op JSON-syntaxisfouten, ontbrekende @context en @type, onbekende schema.org-typen en -eigenschappen en velden die Google nodig heeft voor uitgebreide zoekresultaten.