Test dati strutturati: Schema Markup Validator

Cosa sono i dati strutturati (schema markup)?

I dati strutturati sono un vocabolario standard di schema.org che descrive in forma leggibile dalle macchine di cosa parla una pagina: un prodotto con prezzo e disponibilità, un articolo con autore e data, un'attività con indirizzo e orari di apertura. I motori di ricerca li usano per capire la pagina e, per alcuni tipi, per mostrare i rich result: stelle delle recensioni, prezzi, breadcrumb, date di eventi o dettagli di ricette direttamente nei risultati di ricerca.

Il markup è invisibile ai visitatori. Di solito viene aggiunto come blocco JSON-LD dentro un tag <script type="application/ld+json"> nell'HTML della pagina. Proprio perché nessuno lo vede, gli errori passano inosservati per mesi: un refuso nel nome di una proprietà, un campo obbligatorio mancante o una data nel formato sbagliato disattivano il rich result in silenzio. Un test dei dati strutturati trova questi errori prima che li trovi Google.

JSON-LD, Microdata o RDFa?

JSON-LD è un blocco di JSON separato dentro un tag script; Microdata e RDFa sono attributi (itemscope, itemprop; typeof, property) aggiunti agli elementi HTML visibili. Tutti e tre possono esprimere gli stessi dati schema.org, e Google li legge tutti e tre.

Google consiglia JSON-LD: è più facile da aggiungere e mantenere, può essere generato da un CMS o da un tag manager senza toccare i template e non si rompe quando cambia il layout HTML. I Microdata legano i dati alla struttura della pagina, il che li rende fragili e difficili da controllare. Questo schema validator controlla solo il JSON-LD. Se una pagina contiene anche Microdata o RDFa, lo strumento te lo dice, ma non convalida quelle parti.

Errori comuni nei dati strutturati e come correggerli

La maggior parte degli errori nei dati strutturati rientra in sei gruppi. Il validator spiega ciascuno e, dove possibile, lo corregge nel JSON-LD corretto.

1. JSON non valido. Una virgola di troppo, apici singoli o virgolette tipografiche, una parentesi mancante o un ritorno a capo non convertito rendono illeggibile l'intero blocco: i motori di ricerca lo ignorano del tutto. Soluzione: copia il JSON-LD corretto, che ripara la sintassi e indica la riga di ogni problema.
2. Nomi di proprietà o tipi scritti male. datePublised, Artcle o Reviews non esistono in schema.org. I nomi sconosciuti vengono ignorati in silenzio, quindi il dato va perso senza alcun errore nei report di Google. Soluzione: usa il nome corretto suggerito.
3. Proprietà obbligatorie mancanti. Un Product senza offers, review o aggregateRating, un Event senza una location fisica, un JobPosting senza datePosted: Google non mostra alcun rich result. Soluzione: aggiungi la proprietà; il JSON-LD corretto contiene un segnaposto TODO nel punto giusto.
4. Formati dei valori sbagliati. Date come 25/10/2026 invece di 2026-10-25, prezzi come 19,99 € invece di 19.99, "availability": "Disponibile" invece di https://schema.org/InStock. Soluzione: usa date ISO 8601, numeri puri e gli URL di enumerazione di schema.org.
5. Testo dove è atteso un oggetto. "author": "Jane Doe" dovrebbe essere "author": { "@type": "Person", "name": "Jane Doe" }. Google ha bisogno dell'oggetto per leggere nome e URL.
6. Markup per rich result ritirati. FAQ (ritirato a maggio 2026), How-to (2023) e la casella di ricerca sitelink (2024) sono ancora schema.org valido, ma Google non li mostra più. Il validator lo dice, invece di segnalarli come a posto.

Una cosa che nessuno strumento può controllare: i dati strutturati devono descrivere contenuti realmente visibili nella pagina. Un markup di recensioni, prezzi o eventi che i visitatori non vedono viola le linee guida di Google e può portare a un'azione manuale.

Cosa controlla questa verifica dei dati strutturati

Il validator lavora su tre livelli, dalla pura sintassi fino alle regole di Google:

1. Sintassi JSON. Ogni errore di sintassi è segnalato con riga e colonna, in parole semplici, e riparato nella versione corretta quando è possibile.
2. Vocabolario Schema.org. Ogni tipo e proprietà è controllato sulla versione corrente di schema.org (versione e data sono indicate sotto ogni risultato). I nomi sconosciuti ricevono un suggerimento ortografico; le proprietà che schema.org non definisce per quel tipo, i nomi superati e i tipi di valore attesi (date, URL, numeri, enumerazioni, oggetti annidati) vengono tutti verificati.
3. Requisiti di Google per i rich result. Per Article, Product e Offer, Review e AggregateRating, BreadcrumbList, Organization, LocalBusiness, FAQPage, Event, Recipe, VideoObject e JobPosting lo strumento controlla le proprietà obbligatorie e consigliate di Google Search Central, oltre alle trappole tipiche: posizioni dei breadcrumb, valutazioni fuori scala, date scadute, eventi solo online, offerte di lavoro senza paese.

Gli errori (rossi) rendono il blocco inutilizzabile o bloccano il rich result. Gli avvisi (gialli) sono miglioramenti consigliati. OK (verde) elenca ciò che è già corretto, così vedi a colpo d'occhio cosa troverà Google.

Differenze rispetto al Test dei risultati multimediali e a validator.schema.org

Il Test dei risultati multimediali di Google ti dice se una pagina pubblicata è idonea ai rich result di Google. Segnala “campo mancante” senza spiegare perché né come correggerlo, controlla solo i tipi di risultato di Google e richiede un URL pubblico che Googlebot possa scaricare. Lo Schema Markup Validator di validator.schema.org controlla solo il vocabolario schema.org: non conosce i requisiti di Google e non segnala le proprietà mancanti necessarie a un rich result.

Questo strumento unisce entrambe le prospettive e aggiunge ciò che nessuno dei due fa: una spiegazione in parole semplici e una soluzione concreta per ogni segnalazione, i numeri di riga per gli errori di sintassi, suggerimenti ortografici per i refusi e un JSON-LD corretto da copiare. Il codice incollato è controllato nel tuo browser e non viene mai caricato online. Inoltre ti dice con onestà quando Google ha ritirato un tipo di risultato.

Limiti: lo strumento legge l'HTML così come lo consegna il server e non esegue JavaScript, quindi il markup iniettato da script va incollato a mano. Controlla solo il JSON-LD e non può verificare che il markup corrisponda al contenuto visibile.

Come fare il test dei dati strutturati con questo schema validator

1. Inserisci l'URL della pagina e clicca su “Verifica i dati strutturati”, oppure passa a “Incolla il codice” e incolla un blocco JSON-LD o l'intero sorgente della pagina.
2. Leggi il riepilogo: quanti errori, avvisi ed elementi OK ha la pagina e per quale rich result di Google è idoneo ogni blocco.
3. Apri ogni blocco: correggi prima gli errori rossi, poi gli avvisi gialli. Ogni segnalazione dice cosa è sbagliato, perché conta e come correggerlo.
4. Clicca su “Copia il JSON-LD corretto”, sostituisci i segnaposto TODO con i tuoi dati reali e pubblica il blocco corretto.
5. Ricontrolla la pagina pubblicata tramite URL, poi usa il Test dei risultati multimediali di Google e Search Console per confermare che Google veda lo stesso risultato.