Schema Validator

Fai il test dei dati strutturati di qualsiasi pagina. Vedi gli errori nel markup Schema e cosa dicono i tuoi dati strutturati all'AI sul tuo brand.

oppure per controllarlo prima di pubblicarlo

È gratis

Cos'è il markup Schema?

Il markup Schema è codice che dichiara i fatti di una pagina in una forma che una macchina può leggere senza tirare a indovinare. Una persona vede un nome, un prezzo e cinque stelle. Il markup dice: questo è un prodotto, questo è il suo nome, questo è il prezzo, questa è la valutazione.

Il vocabolario viene da schema.org. Dati strutturati è il nome generico per la stessa cosa, e JSON-LD è il formato che la maggior parte dei siti usa per scriverli: un blocco di codice nella pagina, separato dall'HTML visibile.

I motori di ricerca li usano per capire una pagina e per mostrare risultati più ricchi. I sistemi AI leggono lo stesso blocco quando scaricano la pagina. Per questo è uno dei pochi posti in cui puoi dire chiaramente chi sei e cosa offri, con parole che non lasciano spazio a interpretazioni.

Cosa controlla questo schema validator

Che il codice sia leggibile. Una virgola fuori posto rende illeggibile un intero blocco JSON-LD, e a quel punto un crawler ignora tutto ciò che contiene. Il validator indica il blocco e la riga in cui si rompe.

Che ogni elemento dica cos'è. A un elemento serve un @type, e al blocco serve un @context che punti a schema.org. I tipi distinguono maiuscole e minuscole, e il validator trova quelli scritti nel modo sbagliato.

Che ogni tipo abbia ciò che gli serve. Un Product senza offerta, una FAQ senza risposte, un video senza data di caricamento. Le proprietà obbligatorie mancanti sono errori. Quelle consigliate mancanti sono elencate a parte, così distingui ciò che è rotto da ciò che si può migliorare.

Che i valori abbiano senso. Proprietà vuote, link che non sono URL completi, date che non sono date, prezzi con il simbolo della valuta dentro il numero.

Cosa dice il markup sul tuo brand. Il validator estrae l'elemento Organization e lo mostra come lo legge una macchina: nome, descrizione, sito, logo e i profili elencati in sameAs. È la parte del controllo dei dati strutturati che la maggior parte degli strumenti lascia fuori.

Il codice che incolli viene controllato nel tuo browser e non lascia mai la pagina.

Come fare il test dei dati strutturati

  1. Inserisci l'indirizzo della pagina. Usa la pagina che ti interessa, non soltanto la homepage. Ogni pagina ha il proprio markup.
  2. Leggi le righe in alto. Dicono se sono stati trovati dati strutturati, se contengono errori e se dicono a una macchina chi gestisce il sito.
  3. Guarda la tabella del brand. Mostra i dati della tua Organization così come arrivano a una macchina. Tutto ciò che è segnato come mancante è una lacuna.
  4. Scorri gli elementi. Ogni elemento Schema della pagina è elencato con il suo tipo e il suo risultato.
  5. Correggi ciò che trovi sotto Validazione. Prima vengono gli errori, poi gli avvisi, poi le proprietà consigliate.
  6. Testa la correzione prima di pubblicarla. Incolla il nuovo JSON-LD nel validator e controlla che gli errori siano spariti.

Cosa dicono i dati strutturati all'AI sul tuo brand

Quando un assistente risponde a una domanda su un'azienda, lavora su ciò che ha potuto leggere. Il testo lascia dei vuoti. Questa è l'azienda o un rivenditore? Quello è il sito ufficiale? Questi due profili appartengono allo stesso brand? I dati strutturati rispondono a queste domande in un unico posto.

Organization è l'elemento che conta di più

Un elemento Organization sulla homepage dichiara il tuo nome, il tuo URL e il tuo logo. Aggiungi una description e una macchina ha il tuo riassunto in una riga di ciò che fai, con parole tue.

sameAs collega i punti

sameAs elenca i tuoi altri profili: social network, directory, siti di recensioni. Dice a una macchina che sono tutti la stessa entità. Un brand con i profili collegati tra loro è più facile da riconoscere di uno sparso per il web sotto nomi leggermente diversi.

Un solo nome ovunque

Se l'Organization si chiama in un modo e il WebSite in un altro, una macchina deve decidere quale è giusto. Il validator segnala la differenza. Scegli un nome e indica l'altro come alternateName.

ChatGPT usa i dati strutturati?

Ecco cosa si sa. Google e Microsoft dicono entrambe che i dati strutturati aiutano i loro sistemi a capire una pagina. OpenAI, Anthropic e Perplexity non hanno detto quanto peso danno loro i propri modelli. I loro crawler però scaricano l'HTML, e il JSON-LD ne fa parte.

Il markup Schema quindi non è un interruttore che spinge gli assistenti a citarti. Toglie ogni dubbio su chi sei, e vale la pena farlo perché il costo è un blocco di codice.

Il markup aggiunto da uno script può non essere mai visto

La maggior parte dei crawler AI non esegue JavaScript. Se un tag manager aggiunge i tuoi dati strutturati dopo il caricamento della pagina, il markup non è in ciò che scaricano. Questo validator legge lo stesso HTML, quindi se non trova nulla in una pagina che sai avere il markup, il motivo è questo. L'Agent Readiness Checker mostra quanto di una pagina c'è prima che parta uno script.

I tipi Schema che questo validator controlla

Questi sono i tipi che hanno regole alle spalle. Gli altri tipi di schema.org vengono letti ed elencati, senza un giudizio sulle loro proprietà.

TipoCosa descriveObbligatorieConsigliate
OrganizationChi c'è dietro il sitoname, urllogo, sameAs, description
LocalBusinessUn'attività con una sede fisicaname, addressurl, telephone, image, orari di apertura, sameAs
WebSiteCome si chiama il sitoname, urlNessuna
PersonUn autore o un fondatorenameurl, sameAs, jobTitle
ArticleUn post o una notiziaheadlineauthor, datePublished, dateModified, image, publisher
ProductQualcosa che vendiname, e una tra offers, review o aggregateRatingimage, description, brand, sku
OfferIl prezzo di un prodottopriceCurrency, e price o priceSpecificationavailability
SoftwareApplicationUn'app o uno strumento onlinename, e una tra offers, aggregateRating o reviewapplicationCategory, operatingSystem, description
FAQPageDomande con le loro rispostemainEntity, con un name e un acceptedAnswer per ogni domandaNessuna
BreadcrumbListDove si trova la pagina nel sitoitemListElement, con una position per ogni elementoNessuna
VideoObjectUn video nella paginaname, description, thumbnailUrl, uploadDate, e contentUrl o embedUrlduration
EventQualcosa che accade in una dataname, startDate, locationendDate, image, description, offers, organizer
RecipeUna ricettaname, imagerecipeIngredient, recipeInstructions, author, totalTime
HowToIstruzioni passo per passoname, stepimage, totalTime
JobPostingUna posizione apertatitle, description, datePosted, hiringOrganization, jobLocationvalidThrough, employmentType, baseSalary
Review and AggregateRatingValutazioniratingValue, più un author per una recensione o un conteggio per una valutazione aggregatadatePublished

I sottotipi seguono il tipo da cui derivano. Un Restaurant o un Dentist viene controllato come LocalBusiness, un BlogPosting o un NewsArticle come Article, una WebApplication come SoftwareApplication.

Errori comuni nei dati strutturati

Una virgola dopo l'ultima proprietà. Il JSON non la ammette. L'intero blocco smette di essere leggibile.

Maiuscole sbagliate in un tipo. organization non è Organization. I tipi e i nomi delle proprietà distinguono maiuscole e minuscole.

Nessun @context. Senza, i nomi dei tipi sono solo parole.

Un Product senza offerta. A un prodotto serve un prezzo, una recensione o una valutazione per essere utile a chi lo legge.

Un prezzo con il simbolo della valuta. "price": "$19" è testo. Scrivi "price": "19.00" e metti USD in priceCurrency.

Link relativi. /logo.png non significa nulla fuori dal tuo sito. Usa l'indirizzo completo.

Date in formato locale. Scrivi prima l'anno, come in 2025-03-14, non 14/03/2025.

Markup per cose che la pagina non mostra. Valutazioni e recensioni presenti nel codice che nessun visitatore può vedere violano le regole di Google.

Due plugin che scrivono lo stesso elemento. La pagina si ritrova con due elementi Organization che si contraddicono. Tienine uno.

Schema validator vs Rich Results Test

Gli strumenti rispondono a domande diverse, e conviene usarne più di uno.

StrumentoLa domanda a cui rispondeCosa lascia fuori
Il Rich Results Test di GoogleQuesta pagina può ottenere un risultato avanzato nella Ricerca Google?I tipi che Google non usa per i risultati avanzati
Lo Schema.org validatorIl markup rispetta il vocabolario di schema.org?Se manca qualcosa di obbligatorio per la ricerca
Questo schema validatorIl markup è corretto, e cosa dice a una macchina sul brand?Le regole di idoneità di Google per ciascun risultato avanzato

Se il tuo obiettivo è un risultato avanzato su Google, chiudi con il test di Google. Se il tuo obiettivo è farti capire sia dai motori di ricerca sia dai sistemi AI, inizia da qui.

JSON-LD, microdati e RDFa

I dati strutturati si possono scrivere in tre formati. Usano lo stesso vocabolario.

JSON-LD è un blocco di codice in un tag script. È separato dalla pagina visibile, e per questo è il più facile da scrivere e da mantenere. Google lo consiglia, e la maggior parte dei siti lo usa.

I microdati mettono attributi come itemscope e itemprop direttamente sugli elementi HTML. Funzionano, e si rompono facilmente quando un template cambia.

RDFa fa lo stesso con un altro insieme di attributi ed è il meno diffuso dei tre.

Questo validator controlla a fondo il JSON-LD. Per i microdati elenca i tipi che trova nella pagina, così sai che ci sono.

Domande frequenti

Cos'è uno schema validator?

Uno schema validator legge i dati strutturati di una pagina e ti dice se sono scritti correttamente. Controlla che il codice sia leggibile, che ogni elemento indichi il proprio tipo e che ci siano le proprietà richieste da ciascun tipo. Schema checker e strumento di test dei dati strutturati sono altri nomi per la stessa cosa.

Come faccio il test dei dati strutturati del mio sito?

Inserisci l'indirizzo della pagina nel validator qui sopra. Legge la pagina come fa un crawler, elenca ogni elemento Schema che trova e segnala ciò che manca o è sbagliato. Per testare il codice prima di pubblicarlo, incolla il JSON-LD.

Perché il validator non trova dati strutturati nella mia pagina?

Di solito perché uno script aggiunge il markup dopo il caricamento della pagina. Succede con un tag manager o con un'app renderizzata lato client. Il validator legge l'HTML inviato dal server, che è anche ciò che riceve la maggior parte dei crawler AI. Metti il JSON-LD nel codice sorgente della pagina e verrà trovato.

I dati strutturati aiutano con ChatGPT e gli altri assistenti AI?

Aiutano una macchina a leggere la tua pagina senza tirare a indovinare. Google e Microsoft dicono entrambe che i dati strutturati aiutano i loro sistemi a capire i contenuti. OpenAI, Anthropic e Perplexity non hanno detto quanto peso danno loro i propri modelli. Considerali un modo per dichiarare con chiarezza i fatti sul tuo brand, non un interruttore che spinge gli assistenti a citarti.

Quali tipi Schema contano di più per un brand?

Organization viene per primo, sulla homepage, con nome, URL, logo e link sameAs. WebSite dà al sito il suo nome. Poi dipende dalla pagina: Product per ciò che vendi, Article per ciò che pubblichi, FAQPage per domande e risposte, LocalBusiness se i clienti vengono da te.

Che differenza c'è tra questo strumento e il Rich Results Test di Google?

Il test di Google risponde a una sola domanda: questa pagina può ottenere un risultato avanzato nella Ricerca Google. Guarda solo i tipi che Google supporta a questo scopo. Questo validator controlla il markup in sé e mostra cosa dice a qualsiasi macchina sul tuo brand, compresi i tipi che Google non usa per i risultati avanzati.

JSON-LD è meglio dei microdati?

Per la maggior parte dei siti, sì. Il JSON-LD sta in un unico blocco separato dall'HTML visibile, quindi è più facile da scrivere, da leggere e da tenere corretto. Google lo consiglia. I microdati funzionano ancora, e questo validator elenca i tipi di microdati che vede senza controllarli a fondo.

Il markup Schema può danneggiare il mio sito?

Il markup sbagliato viene per lo più ignorato. Il rischio è il markup che descrive cose che la pagina non mostra, come recensioni o prezzi che non ci sono. Google lo considera spam e può smettere di mostrare i risultati avanzati per il sito.

A cosa serve sameAs?

sameAs elenca gli altri posti in cui il tuo brand ha un profilo, come le sue pagine sui social network, nelle directory aziendali e nelle enciclopedie. Dice a una macchina che sono tutti la stessa entità. Per un brand che vuole farsi riconoscere dall'AI, è la proprietà più utile dopo il nome.

Ogni quanto dovrei validare i miei dati strutturati?

Dopo ogni modifica a un template, a un plugin o a un tema, e dopo un restyling. Il markup si rompe in silenzio: la pagina sembra la stessa e una virgola mancante elimina l'intero blocco.

Un markup Schema pulito dice a una macchina chi sei. Se poi gli assistenti nominano il tuo brand quando qualcuno chiede è un'altra domanda, e a quella risponde il controllo AI Visibility.

Verifica la tua visibilità AI