Verifica dei dati strutturati JSON-LD

Basta incollare il sorgente HTML o il JSON-LD per convalidare i dati strutturati come FAQPage, BreadcrumbList e Article. Elenca le proprietà obbligatorie mancanti o superflue e gli errori che sfuggono più facilmente nei risultati arricchiti di Google: utile per una verifica prima della pubblicazione.

Che cos'è la Verifica dei dati strutturati JSON-LD

JSON-LD è un formato di marcatura che comunica a Google, in modo leggibile da una macchina, che cosa rappresenta davvero un contenuto della pagina: una FAQ, un articolo, un percorso di navigazione e così via. Si scrive come JSON dentro un marcatore <script type="application/ld+json">, per cui aggiunge dati strutturati senza toccare minimamente l'HTML visibile. Se realizzato correttamente, può rendere la pagina idonea ai risultati arricchiti, come il percorso di navigazione nella ricerca. Tenete presente che dal 7 maggio 2026 Google non mostra più i risultati arricchiti delle FAQ (le domande a scomparsa).

Questo strumento estrae automaticamente i blocchi <script> dal sorgente HTML incollato (oppure accetta direttamente il JSON-LD grezzo) e verifica, per ogni entità FAQPage, BreadcrumbList e della famiglia Article (Article / NewsArticle / BlogPosting), le proprietà obbligatorie e consigliate descritte nella documentazione di Google sui dati strutturati (Schema.org di per sé non definisce proprietà obbligatorie). Segnala anche gli errori classici che sfuggono facilmente, come acceptedAnswer.text impostato come oggetto anziché come semplice stringa, oppure valori di position non consecutivi. Effettuare questa verifica prima della pubblicazione, o subito dopo una correzione, permette di scoprire i problemi prima di accorgersene più tardi in Search Console.

Come usare la Verifica dei dati strutturati JSON-LD

  1. Procuratevi il sorgente HTML o il JSON-LD della pagina Va bene sia l'HTML completo ottenuto con "Visualizza sorgente della pagina", sia il solo contenuto di un marcatore <script>.
  2. Incollatelo nel campo di immissione, oppure recuperatelo da un indirizzo Potete incollare il testo direttamente oppure, per una pagina già pubblicata, indicarne l'indirizzo e farlo recuperare automaticamente.
  3. Esaminate le entità individuate e i relativi risultati Se l'immissione contiene più blocchi <script> o più entità @type, ciascuna viene elencata e verificata separatamente.
  4. Correggete le proprietà segnalate come "Non impostata" o "Avviso" Ogni proprietà viene indicata come Corretta, Avviso o Non impostata, così potete individuare subito il punto corrispondente nel JSON-LD originale e correggerlo.
  5. Verificate di nuovo dopo la correzione, prima di pubblicare Incollate di nuovo il JSON-LD corretto e controllate che tutte le proprietà risultino corrette prima di applicare la modifica alla pagina reale.

Consigli per sfruttarlo al meglio

  • Nella proprietà acceptedAnswer di FAQPage inserite il testo della risposta in text come semplice stringa: con un oggetto o un vettore i motori di ricerca non riescono a leggerlo come risposta.
  • I valori di position in BreadcrumbList devono formare una successione che comincia da 1: numeri mancanti o ripetuti impediscono il riconoscimento della sequenza di navigazione.
  • La documentazione di Google non stabilisce proprietà obbligatorie per Article né un limite di caratteri per headline. I titoli lunghi possono però essere troncati su alcuni dispositivi, quindi conviene mantenerli concisi.
  • Anche incollando l'intero sorgente HTML, lo strumento estrae automaticamente il solo contenuto dei blocchi <script type="application/ld+json">: potete comunque incollare la sola parte JSON.
  • Collocando più insiemi di dati strutturati in una stessa pagina, conviene scriverli in marcatori <script> distinti: la manutenzione risulta più agevole.

Quando questo strumento torna utile

Controllare la struttura del markup FAQPage

Individua gli errori di struttura più comuni in FAQPage, come un acceptedAnswer.text malformato. Tenete presente che dal 7 maggio 2026 Google non mostra più i risultati arricchiti delle FAQ, quindi questo markup non cambia più l'aspetto della pagina nella Ricerca Google.

Verificare il percorso di navigazione dopo una riorganizzazione del sito

Quando cambiano le categorie o gli indirizzi, confermate in un solo passaggio che i valori di position del BreadcrumbList restano nell'ordine corretto.

Rivedere lo schema Article di un articolo del blog

Verifica in un colpo solo se mancano proprietà di Article consigliate da Google, come headline, author, datePublished e image.

Individuare la causa di un errore segnalato dalla prova dei risultati arricchiti

Quando lo strumento ufficiale di Google segnala un errore, restringete prima qui il campo a quale proprietà è coinvolta, poi correggete il sorgente.

Glossario

JSON-LD
Una specifica per scrivere i dati strutturati in formato JSON. Viene inserito come blocco autonomo dentro un marcatore <script type="application/ld+json">, così da poter aggiungere informazioni destinate ai motori di ricerca senza modificare la disposizione HTML esistente.
Schema.org
Un vocabolario condiviso per i dati strutturati, mantenuto insieme da Google, Microsoft, Yahoo e altri. Definisce i tipi (@type), come FAQPage o Article, e le proprietà che ciascuno supporta.
FAQPage
Un tipo di Schema.org per le domande frequenti e le relative risposte. Il suo mainEntity contiene un vettore di entità Question, ciascuna con name (la domanda) e acceptedAnswer.text (la risposta). Dal 7 maggio 2026 Google non mostra più i risultati arricchiti delle FAQ nella ricerca.
BreadcrumbList
Un tipo di Schema.org che rappresenta un percorso di navigazione, cioè la posizione della pagina nella gerarchia di un sito. Il suo itemListElement contiene un vettore di entità ListItem, ciascuna con position, name e item (URL). Secondo la documentazione di Google, item può essere omesso nell'ultimo elemento: in tal caso si usa l'URL della pagina stessa.
Risultati arricchiti
Risultati di ricerca che mostrano più informazioni del solito titolo e della descrizione, come il percorso di navigazione. Dati strutturati implementati correttamente sono un requisito, ma non garantiscono che il risultato arricchito venga mostrato.
Proprietà obbligatoria
Una proprietà che Google richiede perché un determinato risultato arricchito compaia; se manca, il risultato arricchito semplicemente non appare. Una proprietà raccomandata, invece, non è strettamente obbligatoria ma migliora la resa del risultato.
Google Search Console
Lo strumento ufficiale di Google per monitorare il rendimento nella ricerca e lo stato di indicizzazione di un sito. La relazione sui miglioramenti mostra come Google interpreta effettivamente i dati strutturati delle pagine pubblicate.

Domande frequenti

JSON-LD scrive i dati strutturati in formato JSON dentro un marcatore <script> indipendente dal corpo della pagina. Microdata e RDFa li incorporano invece negli attributi dei marcatori HTML e richiedono quindi di modificare la struttura esistente. Google raccomanda ormai JSON-LD, che per la sua facilità di realizzazione è diventato la scelta prevalente.

I dati strutturati non sono un fattore di posizionamento diretto. Tuttavia, se un markup come BreadcrumbList è implementato correttamente, la pagina può mostrare risultati arricchiti come il percorso di navigazione, con un possibile aumento della percentuale di clic (CTR). Le domande frequenti a scomparsa non vengono più mostrate: Google le ha eliminate il 7 maggio 2026.

Schema.org definisce il text di una Answer come stringa (tipo Text). Inserendovi per errore un oggetto o un vettore, per esempio una struttura annidata del tipo {"value": "risposta"}, i motori di ricerca non riescono a leggerlo come testo della risposta.

Sì, senza problemi. Schemi di tipo diverso — FAQPage, BreadcrumbList, Article — possono convivere nella stessa pagina in marcatori <script type="application/ld+json"> distinti. Anche questo strumento individua e verifica insieme più blocchi e più entità da una sola immissione.

Con la relazione sui miglioramenti di Google Search Console oppure con la prova ufficiale dei risultati arricchiti, che mostrano come Google interpreti l'indirizzo effettivamente pubblicato. Questo strumento si presta invece alla verifica preliminare, prima della pubblicazione o subito dopo una correzione.
Tool-kun

A proposito — perché JSON-LD ha soppiantato Microdata e RDFa

JSON-LD, cioè JSON per i dati collegati, nacque nella prima metà degli anni Dieci da un gruppo di lavoro del consorzio del web come formato per i dati collegati. A differenza delle notazioni precedenti, che incorporavano i dati strutturati negli attributi degli elementi HTML, JSON-LD si scrive come JSON autonomo dentro un marcatore <script>: se ne possono quindi aggiungere e togliere senza toccare minimamente la disposizione della pagina. Google lo indica come formato raccomandato dal 2015 circa e oggi anche la documentazione sui risultati arricchiti presuppone questa notazione.

Anche la sezione delle domande frequenti di questo sito funziona così: basta scrivere nella pagina le domande e le risposte una a una perché il JSON-LD in formato FAQPage venga generato internamente. Non occorre battere due volte, per le persone e per i motori di ricerca, lo stesso contenuto: correggendone uno l'altro segue da sé, e si evita così ogni discrepanza fra ciò che si vede e lo schema dichiarato.

Anche quando il JSON è sintatticamente ineccepibile, se mancano le proprietà richieste o raccomandate da Google i risultati arricchiti, come la sequenza di navigazione nei risultati di ricerca, possono non comparire. Le proprietà profondamente annidate come acceptedAnswer.text sono l'esempio tipico di ciò che si sbaglia più facilmente. Una verifica meccanica prima della pubblicazione permette di scoprire i difetti assai prima di accorgersene nella relazione sui miglioramenti di Search Console.