NeovaPiattaforma SEO avanzata

Validatore di schema markup: controlla i dati strutturati su una pagina o su tutto il sito

I dati strutturati dicono ai motori di ricerca di cosa parla una pagina in una forma che possono leggere senza indovinare: questo è un prodotto, questo è il suo prezzo, questo è l'autore. Un validatore di schema markup legge quel markup e ti dice se viene analizzato correttamente, se usa il vocabolario nel modo giusto e se è abbastanza completo per una funzionalità di ricerca. Una pagina è facile da testare. Un sito con migliaia di pagine generate da template ha bisogno dello stesso test ovunque.

Dati strutturatischema markup validatorAggiornato il 21 novembre 2026A cura del team di Neova

Cosa controlla un validatore di schema markup

La validazione avviene su quattro livelli, e ognuno intercetta un tipo diverso di problema:

  1. Sintassi. Il JSON-LD viene analizzato? Ogni proprietà microdata è dentro un item? Una virgola mancante o una virgoletta senza escape possono rendere illeggibile un intero blocco.
  2. Vocabolario. I tipi e le proprietà sono termini Schema.org reali, usati sui tipi a cui appartengono? Una proprietà scritta male è JSON valido ma non significa nulla.
  3. Requisiti delle funzionalità. Google documenta proprietà obbligatorie e consigliate per ogni risultato multimediale che supporta. Il markup può essere Schema.org valido e mancare comunque di una proprietà che serve a Google per uno snippet prodotto o una scheda evento.
  4. Corrispondenza con la pagina. Le linee guida sui dati strutturati di Google chiedono che il markup descriva contenuti che i visitatori possono vedere. Un prezzo nel markup che non è nella pagina, o un titolo diverso da quello visibile, è un problema di qualità che nessun controllo della sintassi troverà.

La maggior parte degli strumenti per singola pagina copre i primi tre. Il quarto richiede il markup e la pagina renderizzata uno accanto all'altro.

Il validatore di Schema.org e il Test dei risultati multimediali di Google

Due strumenti gratuiti testano una pagina alla volta, e rispondono a domande diverse. L'introduzione ai dati strutturati di Google consiglia il Test dei risultati multimediali mentre costruisci.

Schema Markup ValidatorTest dei risultati multimediali
Sviluppato daSchema.orgGoogle
Pagine per test11
URL o codice incollato✓✓
JSON-LD, microdata, RDFa✓✓
Tutto il vocabolario Schema.org✓–
Idoneità ai risultati multimediali di Google–✓
Proprietà obbligatorie mancanti–✓
Anteprima del risultato–✓

Lo Schema Markup Validator ha sostituito il vecchio Strumento di test per i dati strutturati di Google. Usalo per sapere se il markup è Schema.org corretto, compresi i tipi che alimentano knowledge panel o risposte AI ma non hanno un risultato multimediale. Usa il Test dei risultati multimediali quando l'obiettivo è una specifica funzionalità di Google. Nessuno dei due testa un intero sito in una volta. SEO ProCheck spiega come fare il debug dei risultati multimediali che non funzionano con entrambi.

JSON-LD, microdata e RDFa

Google legge tutti e tre i formati e dice che vanno ugualmente bene se validi, ma consiglia JSON-LD perché sta in un solo blocco script, separato dall'HTML, ed è il più facile da mantenere corretto tra i template. Un blocco Product minimo è così:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Trail Running Shoe",
  "image": "https://www.example.com/shoe.jpg",
  "offers": {
    "@type": "Offer",
    "price": "89.00",
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Microdata e RDFa mettono gli stessi dati in attributi sull'HTML visibile. Questo tiene il markup vicino al contenuto, ma una modifica al template HTML può romperlo senza che nessuno se ne accorga. Qualunque formato usi, usane uno per item; descrivere lo stesso prodotto due volte in due formati è un invito a farli divergere.

Errori comuni nei dati strutturati

  • JSON rotto. Una virgola finale, una virgoletta tipografica incollata da un documento o un a capo grezzo dentro una stringa.
  • @context o @type mancanti. Senza di essi, un parser non sa cosa descrive il blocco.
  • Proprietà obbligatorie mancanti. Vedi la tabella qui sotto.
  • Markup che non concorda con la pagina. Un prezzo cambiato nella pagina ma non nel markup.
  • Valori scaduti. Un'offerta il cui priceValidUntil è passato, o un dateModified precedente al datePublished.

Proprietà obbligatorie per alcune funzionalità comuni, dalla galleria della Ricerca di Google:

TipoObbligatorie per Google
Snippet prodottoname, più offers, review o aggregateRating
Eventname, startDate, location
Recipename, image
BreadcrumbListitemListElement: name, position, item
Article0 (tutte consigliate)

Alcuni markup sono validi ma non rendono più ciò che rendevano:

MarkupCambiamentoDal
data-vocabulary.orgNon supportato2021
HowToNessun risultato multimedialeSettembre 2023
FAQPageSolo siti governativi e sanitariAgosto 2023
FAQPageNessun risultato multimedialeMaggio 2026

Perché una sola pagina non basta

I dati strutturati sono quasi sempre prodotti dai template. Quando si rompono, si rompono su ogni pagina servita dal template, o sul sottoinsieme in cui un campo è vuoto. Testare la pagina prodotto che ti capita di aprire non ti mostrerà che 300 prodotti non hanno prezzo perché il loro campo prezzo è un intervallo, o che gli articoli di un certo autore non hanno il markup dell'autore.

Tre cose emergono solo su un intero sito:

  • Copertura. Quali gruppi di pagine hanno il markup, e quali pagine di un gruppo non hanno ciò che hanno le altre.
  • Casi limite. Campi vuoti, caratteri strani e valori presenti solo in alcuni record.
  • Deriva. Markup valido al lancio che ha smesso di esserlo dopo un rilascio. La documentazione di Google consiglia di tenere d'occhio i report dei risultati multimediali dopo il deploy proprio per questo motivo.

Come validare lo schema markup su tutto un sito

  1. Scansiona il sito ed estrai i dati strutturati da ogni pagina HTML. Se una parte del markup viene inserita da JavaScript, renderizza anche le pagine, come descritto nella guida al crawler SEO per JavaScript.
  2. Correggi prima gli errori di sintassi. Su un blocco che non viene analizzato non si può controllare nient'altro.
  3. Raggruppa le pagine per template ed elenca i tipi presenti in ogni gruppo. Cerca le pagine a cui manca un tipo che ha la maggior parte del loro gruppo.
  4. Controlla le proprietà obbligatorie per le funzionalità che vuoi, poi quelle consigliate.
  5. Confronta il markup con il testo visibile: nomi, titoli e prezzi devono comparire nella pagina.
  6. Fai un controllo a campione nel Test dei risultati multimediali su una pagina per template, per confermare cosa vede Google.
  7. Tieni d'occhio Search Console dopo ogni rilascio: i report dei risultati multimediali e Controllo URL mostrano cosa ha trovato Google con il proprio crawl.

I dati strutturati sono un passo della checklist per l'audit SEO tecnico, e un markup pulito aiuta anche i sistemi di AI a leggere una pagina, come spiega la guida al crawler SEO con AI.

Valida i dati strutturati con Neova

La categoria Dati strutturati di Neova classifica lo schema markup di ogni pagina come valido, con avvisi o con errori, aggiunge una colonna Tipi Schema e dà un giudizio per ogni tipo nel pannello dell'URL. Legge JSON-LD, microdata e RDFa da ogni pagina HTML del crawl. Alcuni dei controlli:

Poiché Neova trova i gruppi di pagine dall'HTML, un problema di template emerge come un solo gruppo con la stessa segnalazione invece di migliaia di righe separate. Le domande su tipi e formati trovano risposta nelle FAQ sullo schema markup di SEO ProCheck. Vedi le Funzionalità o scarica Neova; il piano Free scansiona 1.000 URL con ogni controllo.

Domande

Cos'è un validatore di schema markup?

Uno strumento che legge i dati strutturati di una pagina, in JSON-LD, microdata o RDFa, e verifica che vengano analizzati, che usino correttamente tipi e proprietà Schema.org e, per alcuni strumenti, che abbiano ciò che richiede una funzionalità di ricerca.

Qual è la differenza tra lo Schema Markup Validator e il Test dei risultati multimediali?

Lo Schema Markup Validator su validator.schema.org verifica il markup sull'intero vocabolario Schema.org. Il Test dei risultati multimediali di Google verifica per quali risultati multimediali di Google una pagina è idonea e quali proprietà obbligatorie o consigliate mancano.

Dati strutturati validi garantiscono un risultato multimediale?

No. Google dice che un markup valido rende una pagina idonea, non garantita. Decide se mostrare un risultato multimediale in base alla query, alla pagina e alle sue linee guida sulla qualità.

Posso validare lo schema markup su tutto un sito?

Non con gli strumenti per singola pagina. Un crawler che estrae e controlla i dati strutturati su ogni pagina mostra i problemi di template, il markup mancante e le pagine diverse dal loro gruppo, poi fai un controllo a campione su una pagina per template nel Test dei risultati multimediali.

Quale formato di dati strutturati devo usare?

Google legge JSON-LD, microdata e RDFa e consiglia JSON-LD, perché sta in un solo blocco separato dall'HTML ed è il più facile da mantenere.

Porta questa guida con te

I link agli assistenti si aprono con una domanda su questa pagina già scritta.

Scansiona il tuo sito con NeovaIl piano Free esegue ogni controllo su Mac, Windows e Linux. Nessuna carta di credito richiesta.

Continua a leggere