Command Palette

Search for a command to run...

Schema Markup Generator: Bouw Geldige JSON-LD Gestructureerde Gegevens Zonder het Raadselwerk

Schema Markup Generator: Bouw Geldige JSON-LD Gestructureerde Gegevens Zonder het Raadselwerk

T
Toolz Team
|Aug 23, 2026|17 min lezen

Onderdeel van de collectie SEO-tools

De eerste keer dat ik schema-opmaak aan een clientsite toevoegde, typte ik met de hand a Product blokkeer de themaheader, implementeer deze en blijf je slim voelen. Twee weken later vertelde de Rich Results Test me dat het biedobject zijn doel miste @type, de prijs was een getal waarbij Google een string wilde, en een verdwaalde achterliggende komma het hele blok stilletjes ongeldig had gemaakt Google had het de hele tijd genegeerd Dat is waar niemand je voor waarschuwt met gestructureerde gegevens: ongeldige JSON-LD gooit geen fout of kleurt niets rood Het doet gewoon stilletjes niets, en je komt er maanden later achter wanneer het rijke resultaat waarop je rekende nooit opduikt.

De woordenschat zelf wordt gepubliceerd op schema.org, en waarvoor Google daadwerkelijk een rijk resultaat zal laten zien, is een smallere lijst in zijn documentatie over gestructureerde gegevens.

Ik bouw tools voor de kost - Toolz.dev, de WP Adminify plugin, een stapel Laravel en React apps - en gestructureerde data is een van die taken die ik vaak genoeg doe om het met de hand te doen en zelden genoeg om de exacte eigendomsnamen elke keer te vergeten Dus heb ik de gebouwd Schema Markup Generator om de twee faalmodi te verwijderen die mij het meeste kosten: verkeerde nesting en stille invaliditeit Deze gids doorloopt wat schema-opmaak eigenlijk doet, hoe de generator deze bouwt en de specifieke fouten die ervoor zorgen dat geldig ogende opmaak geen rijke resultaten oplevert.

tl;dr: Schema markup zijn gestructureerde gegevens (met behulp van de schema.org woordenschat) die zoekmachines precies vertellen waar een pagina over gaat, waardoor het in aanmerking komt voor rijke resultaten zoals FAQ accordeons, productprijzen, en broodkruimels Google beveelt het JSON-LD formaat aan - een op zichzelf staande <script type="application/ld+json"> blok. De generator bouwt geldige JSON-LD voor negen veel voorkomende typen, nestelt subobjecten zoals PostalAddress en Offer correct, vlaggen missen verplichte en aanbevolen velden, en draait 100% in uw browser, zodat niets dat u typt wordt geüpload.

Wat is schemaopmaak, en waarom maakt het uit?

Schema markup is een gestandaardiseerde manier om de inhoud van een pagina te beschrijven, zodat machines deze kunnen begrijpen en niet alleen kunnen renderen. De woordenschat komt van schema.org, een gedeeld project ondersteund door Google, Microsoft, Yahoo en Yandex. Wanneer u een pagina markeert als een Article, u vertelt een zoekmachine & quot; dit is een nieuws- of blogartikel, hier is de kop, hier is wie het heeft geschreven, hier is toen het werd gepubliceerd.&quot; Die gestructureerde beschrijving zorgt ervoor dat een pagina in aanmerking komt voor rijke resultaten: de verbeterde vermeldingen met sterbeoordelingen, prijzen, FAQ-uitval, evenementdata en broodkruimelpaden die meer ruimte in beslag nemen en meer klikken verdienen dan een effen blauwe link.

De reden dat het ertoe doet is de laatste paar jaar veranderd Vroeger ging het puur om rijke resultaten in Google Nu voeden gestructureerde data ook AI-antwoord-engines en Google&#39; s AI Overzichten Wanneer ChatGPT, Perplexity, of Gemini proberen samen te vatten wat uw bedrijf doet of welk product overeenkomt met een query, zijn clean structured data een van de signalen die hen helpt om de feiten goed te krijgen Een pagina die zichzelf duidelijk een Organization met een naam, logo en sociale profielen is het voor elke machine veel gemakkelijker om over te redeneren dan een machine die alles impliciet in de HTML laat.

Het addertje onder het gras is dat gestructureerde gegevens meedogenloos zijn. Het is code en code moet precies goed zijn. Een eigenschap gespeld datePublish in plaats van datePublished wordt gewoon genegeerd An Offer zonder een @type wordt niet herkend als een aanbod En omdat geen van deze fouten de zichtbare pagina breken, verbergen ze zich voor onbepaalde tijd in de productie Dat is de leemte die een generator opvult - niet het schrijven van de concepten voor u, maar het krijgen van de syntaxis en structuur elke keer goed.

Waarom JSON-LD in plaats van Microdata of RDFa?

Er zijn drie manieren om schema.org gegevens toe te voegen aan een pagina, en het helpt om te begrijpen waarom de generator slechts één van hen produceert.

Microdata en RDFa weave de gestructureerde gegevens direct in uw zichtbare HTML met behulp van extra attributen - itemscope, itemprop, property, enzovoort. Jouw <div> voor een productbeoordeling krijgt attributen die elk stuk zichtbare tekst labelen Dit werkt, maar het koppelt uw opmaak strak aan uw paginastructuur Verander de lay-out en u loopt het risico het schema te breken Het is ook breedsprakig en moeilijk te lezen.

JSON-LD hanteert de tegenovergestelde aanpak Het plaatst alle gestructureerde gegevens in één op zichzelf staand geheel <script type="application/ld+json"> blok, meestal in de <head>, volledig los van de zichtbare HTML Google heeft JSON-LD al jaren aanbevolen juist vanwege deze scheiding: je kunt het toevoegen, bijwerken of injecteren via een tag manager zonder je sjablonen aan te raken Het is het formaat dat elke moderne schema tutorial leert, en het is wat de generator uitvoert.

formaat Waar het leeft Gemak van onderhoud Google&#39;s-standpunt
JSON-LD Single <script> blok, los van HTML Gemakkelijkst - één blok bewerken aanbevolen
Microdata Kenmerken binnen zichtbare HTML Harder - gekoppeld aan lay-out ondersteund
RDFa Kenmerken binnen zichtbare HTML Harder - gekoppeld aan lay-out ondersteund

Als je in WordPress werkt, is JSON-LD ook wat de meeste SEO-plug-ins injecteren, en waar een tool als WP Adminify netjes naast zit. Omdat het een op zichzelf staand blok is, kun je het hier genereren en in een aangepast HTML-veld, een tagmanager of een Laravel Blade-indeling plakken zonder enige raamwerkspecifieke gymnastiek.

Hoe gebruik ik de Schema Markup Generator?

De workflow is opgebouwd rond het kiezen van een type en het invullen van een kort formulier, met een live preview, zodat u de JSON-LD-assemble ziet terwijl u typt.

Stap 1 - Kies een schematype. Kies uit Organisatie, LocalBusiness, WebSite, Artikel, Product, FAQPage, Broodkruimellijst, Persoon of Evenement Het formulier wisselt onmiddellijk naar de velden die type nodig heeft Deze negen bestrijken de overgrote meerderheid van waar kleine en middelgrote sites daadwerkelijk markup voor nodig hebben.

Stap 2 - Vul de velden in. Vereiste velden zijn gemarkeerd met een asterisk Terwijl u typt, stelt de tool de JSON-LD samen en laat elk veld dat u leeg laat vallen, zodat u nooit leeg raakt "" eigenschappen die de uitvoer vervuilen Voor op adressen gebaseerde typen zoals LocalBusiness en Event worden de afzonderlijke adresvelden opgevouwen tot een correct getypt PostalAddress object automatisch.

Stap 3 - Bekijk de validatie. De generator signaleert twee soorten problemen Fouten (ontbrekende verplichte velden, verkeerd opgemaakte URL's) blokkeren een schoon resultaat en worden in rood weergegeven Waarschuwingen (ontbrekende door Google aanbevolen velden zoals image of datePublished, of een zoek-URL-sjabloon die de tijdelijke aanduiding mist) worden weergegeven in amber - de opmaak is nog steeds geldig, maar u laat een potentieel met rijk resultaat op tafel liggen.

Stap 4 - Kopiëren en implementeren. Schakel tussen de volledige <script> tag (klaar om in uw te plakken <head>) en de rauwe JSON (voor tagmanagers en CMS-velden) De scriptuitvoer ontsnapt aan de tekens die anders zouden afwijken </script> in uw gegevens breek de pagina Vervolgens valideer de live pagina met Google&#39; s Rich Results Test.

Omdat alles aan de clientzijde draait, is dit veilig om te gebruiken op niet-gepubliceerde productpagina's, ensceneringsomgevingen en clientwerk onder NDA. Uw prijzen, gebeurtenisgegevens en interne URL's verlaten nooit de browser - dezelfde privacyhouding achter elke tool op de site, waarover ik schreef in de Gids voor gegevensprivacy.

Welke schematypen moet ik eigenlijk gebruiken?

Niet elke pagina heeft markup nodig, en het stapelen op typen die je niet kunt ondersteunen is erger dan geen. Hier is hoe ik denk over de negen die de generator bedekt.

Organisatie hoort op uw startpagina of een over-pagina - het is het schema dat kennispanels voedt en Google helpt uw merk te verbinden met zijn sociale profielen via sameAs. Website koppelt ermee en kan een Sitelinks-zoekvak declareren via een SearchAction, zodat gebruikers uw site rechtstreeks vanaf de resultatenpagina kunnen doorzoeken. LokaalZakelijk is essentieel als u een fysieke locatie heeft: deze bevat uw adres, telefoon, prijsklasse en openingstijden en ondersteunt de lokale pakket- en kaartresultaten.

Artikel (die de generator uitzendt met Article type, even geldig voor blogposts) markeert redactionele inhoud met een kop, auteur, uitgever en publicatiedata. Product beschrijft iets te koop, met een geneste Offer het dragen van prijs, valuta en beschikbaarheid - dit is wat prijs- en beschikbaarheidsfragmenten mogelijk maakt. Event omvat alles met een datum en plaats, van een conferentie tot een webinar.

FAQPagina en Broodkruimellijst zijn structureel in plaats van over een &quot;thing.&quot; FAQPage markeert vraag-en-antwoord-inhoud; merk op dat Google de resultaten van veelgestelde vragen heeft beperkt tot gezaghebbende overheids- en gezondheidssites, maar de opmaak helpt andere zoekmachines en AI-antwoordmachines nog steeds bij het parseren van uw vraag-en-antwoordversie;A. BreadcrumbList produceert het broodkruimelspoor dat onder uw titel in resultaten wordt weergegeven, wat de manier waarop uw URL-structuur leest verbetert. Person markeert een individu - een auteur, oprichter of publieke figuur - en is nuttig voor auteursbios en EET-signalen.

De regel die ik volg: markeer waar de pagina echt over gaat, en claim alleen eigenschappen die inhoud weerspiegelen die daadwerkelijk zichtbaar is op de pagina. Google&#39; De richtlijnen zijn expliciet dat gestructureerde gegevens echte, zichtbare inhoud moeten beschrijven - het markeren van een prijs die niet op de pagina verschijnt is een overtreding en geen snelkoppeling.

Hoe houdt de generator de markup geldig?

De waarde zit in de details die makkelijk met de hand fout te krijgen zijn Een paar die het waard zijn om te roepen.

Correcte nesting met @type. In JSON-LD zijn geneste objecten geen gewone subobjecten; ze hebben allemaal hun eigen subobjecten nodig @type. Een adres is een PostalAddress, een aanbod is een Offer, een artikel&#39;s auteur is een Person, de uitgever is een Organization wiens logo een ImageObject. De generator bouwt al deze met het juiste type, zodat de parser ze herkent in plaats van ze als anonieme klodders te behandelen.

Snoeien leegt. Als u een veld leeg laat, moet de eigenschap worden verwijderd en niet worden uitgezonden "telephone": "". Lege tekenreeksen en lege arrays worden automatisch van de uitvoer verwijderd, dus wat u kopieert is altijd schoon.

Scriptveilig ontsnappen. Het gevaarlijkste personage in de inline JSON-LD is een < - specifiek de volgorde </script> verschijnen in uw gegevens (bijvoorbeeld in een beschrijving), waardoor het scriptblok vroegtijdig wordt beëindigd en de pagina wordt verbroken. De generator ontsnapt <, >, en & in de scripttaguitvoer met behulp van unicode-escapes, wat precies is wat Google&#39; zijn eigen voorbeelden doen.

Vereiste en aanbevolen bewustwording. Elk type draagt zijn eigen lijst van wat Google vereist versus aanbeveelt Artikel wil echt een image en datePublished; Product wil een price; Gebeurtenis heeft een startDate. De tool onderscheidt harde vereisten (die het als fouten behandelt) van aanbevelingen (waarschuwingen), zodat u het verschil kent tussen & quot; dit zal niet werken&quot; en &quot; dit zou beter kunnen werken.&quot;

Als u een bredere technische workflow aan het samenstellen bent, staat de schemagenerator op natuurlijke wijze naast de andere SEO-hulpprogramma's: de Meta-tag-generator voor uw titel, beschrijving en Open Graph-tags, en de XML-sitemapgenerator voor het indienen van uw URL's Samen bestrijken ze het grootste deel van het technische SEO-oppervlak op de pagina, en om die reden heb ik ze gegroepeerd in de overzicht van webontwikkelaarstoolkits.

Hoe test en implementeer ik gestructureerde data?

Het genereren van geldige JSON-LD is de helft van de taak; de andere helft bevestigt dat Google het leest zoals u het wilt.

Begin met Google&#39;s Rich Results Test, die een URL ophaalt of geplakte code accepteert en rapporteert voor welke rijke resultaattypen de pagina in aanmerking komt, plus eventuele fouten of waarschuwingen. Voer vervolgens dezelfde opmaak uit via de Schema Markup Validator op validator.schema.org, die de conformiteit met de woordenschat van schema.org zelf controleert in plaats van Google&#39; s rich-result requirements De twee vangen verschillende dingen op: de Rich Results Test vertelt u of u in aanmerking komt voor een specifieke Google-functie, terwijl de validator u vertelt of de markup structureel gezond is schema.org.

Zodra de pagina live is, rapporteert de verbetering Google Search Console houd prestaties bij in de tijd en markeer fouten die Google tijdens het crawlen vindt Hier vang je problemen op die alleen op schaal verschijnen - een sjabloon die dubbele broodkruimelposities uitzendt, bijvoorbeeld, of een productfeed die af en toe een vereist veld weglaat.

Voor implementatie plakt u de <script> blok in de <head> van de specifieke pagina die het beschrijft Plaats geen enkel Productblok in een globale sjabloon die op elke pagina draait - de markup moet overeenkomen met de pagina waarop het leeft In een CMS gebruikt u welk aangepast HTML- of SEO-veld het platform u ook geeft In een tagmanager gebruikt u een aangepaste HTML-tag en kopieert u de JSON. In een React- of Laravel-app injecteert u de blokserverzijde, zodat crawlers deze in de initiële HTML zien in plaats van na hydratatie.

Veelgemaakte fouten zie ik nog steeds

Keer op keer komen er een handvol fouten naar voren, en elk ervan levert een opmaak op die er prima uitziet, maar niets doet.

De klassieker is onzichtbare inhoud markeren - het toevoegen van een review rating of prijs die nergens op de pagina voorkomt Google verbiedt dit expliciet en kan er een handmatige actie voor uitvaardigen De tweede is het verkeerde type op een genest object, meestal ontbreekt er een @type op een adres of aanbieding De derde is vergelijkbare typen samenvoegen, zoals gebruiken Product markup op een pagina met een categorievermelding in plaats van op een enkel product. En de vierde, mijn persoonlijke aartsvijand, is een syntaxisfout van handbewerken - een achterliggende komma of een niet-ontsnapte aanhalingsteken die het hele blok ongeldig maakt.

Dit alles is de reden waarom een generator zijn geld verdient. Het kan niet weten of uw prijs zichtbaar is op de pagina - dat staat op u - maar het zal nooit een achterliggende komma uitzenden, een ontbrekende @type, of een lege eigenschap Dat alleen al verwijdert de meeste manieren waarop gestructureerde gegevens stilletjes falen Voor diepere achtergrondinformatie over de ontwikkelaarsworkflows rond dit soort tools, de Handleiding voor coderingshulpmiddelen is een goede metgezel lees.

Veelgestelde vragen

Wat is Schema Markup?

Schema markup is gestructureerde data die een pagina beschrijft&#39; s content naar zoekmachines met behulp van de gedeelde schema.org woordenschat Het toevoegen ervan kan een pagina in aanmerking laten komen voor rijke resultaten zoals FAQ accordeons, productprijzen, review sterren, en broodkruimels JSON-LD, het formaat dat deze tool produceert, is de syntaxis die Google aanbeveelt omdat het in een enkele scripttag leeft die los staat van je zichtbare HTML.

Wat is het verschil tussen JSON-LD, Microdata en RDFA?

Alle drie zijn manieren om schema.org gestructureerde gegevens aan een pagina toe te voegen. Microdata en RDFA zijn attributen die in uw zichtbare HTML zijn verweven, terwijl JSON-LD een op zichzelf staand blok JSON is in een scripttag. Google raadt JSON-LD aan omdat het gemakkelijker is om toe te voegen, bij te werken en gescheiden te houden van de pagina-opmaak. Deze tool voert om die reden JSON-LD uit.

Waar plaats ik de gegenereerde JSON-LD?

Plak de volledige <script type="application/ld+json"> tag in de <head> van de pagina die het beschrijft, of waar dan ook in de <body> - Google leest het op beide locaties Als je Google Tag Manager gebruikt, kopieer je de JSON en voeg je deze toe via een aangepaste HTML-tag Plaats de markup altijd op dezelfde pagina waarvan de inhoud wordt beschreven, niet op een sjabloon die deze overal toepast.

Garandeert het toevoegen van schema-opmaak rijke resultaten?

heel weinig Geldige gestructureerde gegevens maken een pagina in aanmerking voor rijke resultaten, maar Google beslist of ze deze willen weergeven op basis van kwaliteit, relevantie en zijn eigen richtlijnen. Uw markering moet ook inhoud weergeven die daadwerkelijk zichtbaar is op de pagina. Zie schema als een vereiste voor rijke resultaten, niet als een schakelaar die ze aanzet.

Hoe test ik mijn gestructureerde gegevens?

Voer de gegenereerde markup uit via Google&#39; s Rich Results Test en de Schema Markup Validator (schema.org&#39; s validator) Zowel parseer uw JSON-LD als rapporteer ontbrekende vereiste velden of syntaxisfouten Nadat de pagina live is, volgen de Google Search Console-verbeteringsrapporten hoe uw gestructureerde gegevens in de loop van de tijd presteren.

Welke velden zijn vereist voor elk type?

Vereisten verschillen per type: artikel heeft een kop nodig, product heeft een naam nodig, gebeurtenis heeft een naam en startdatum nodig, en FAQPage heeft ten minste één vraag en antwoord nodig. Deze tool markeert verplichte velden en blokkeert de uitvoer totdat ze zijn ingevuld, terwijl ze ook waarschuwen voor aanbevolen velden die uw kansen op het behalen van een rijk resultaat vergroten.

Kan ik FAQ-schema's voor mijn pagina genereren?

Ja. Kies het type FAQPage, voeg elke vraag met zijn antwoord toe en de tool bouwt automatisch de mainentity-array van vraag- en antwoordobjecten op. Merk op dat Google nu veelgestelde vragen over rijke resultaten toont, voornamelijk voor gezaghebbende overheids- en gezondheidssites, maar de markup blijft geldig en nuttig voor andere zoekmachines en AI-antwoordengines.

Worden mijn gegevens privé gehouden?

Ja. De JSON-LD wordt volledig in uw browser geassembleerd met gewoon JavaScript. Niets dat u typt - inclusief niet-gepubliceerde prijzen, gebeurtenisgegevens of privé-URL's - wordt verzonden, geregistreerd of opgeslagen, en de generator blijft werken zonder dat er een netwerkverbinding is geladen.


Comments

0 comments

0/2000 characters

No comments yet. Be the first to share your thoughts!