Vai al contenuto principale
← Tutte le guide

Dati strutturati

Il markup schema descrive una pagina a una macchina con un vocabolario che essa già conosce. Quello che compra è l'idoneità a un risultato più ricco: mai un posizionamento e mai una garanzia.

Idoneità, non posizionamento

Un markup valido rende una pagina idonea a un risultato avanzato. Google sceglie quella parola di proposito: includere tutte le proprietà richieste qualifica la pagina per una presentazione arricchita, non la promette, e i dati strutturati non sono di per sé un fattore di ranking.

La distanza tra idonea e mostrata è più ampia di quanto quasi tutti si aspettino, e non è arbitraria. Che un arricchimento compaia dipende dalla query, dal dispositivo, dal paese, dall'esistenza della funzione in quella lingua e dal giudizio di Google su quanto aiuti in quel contesto. La stessa pagina può mostrare le stelle in una ricerca e non nella successiva.

JSON-LD è il formato da usare

Tutte e tre le sintassi — JSON-LD, Microdata e RDFa — sono ugualmente accettabili per Google, e JSON-LD è quella che raccomanda. La raccomandazione è pratica più che tecnica.

JSON-LD sta in un unico tag script invece di essere infilato nel markup come attributi sugli elementi che descrive. Così sopravvive a una rifattorizzazione dei template, si legge in un solo punto quando qualcun altro lo eredita, e un errore al suo interno non disturba la pagina visibile. Microdata accoppia la descrizione alla presentazione, quindi ogni restyling rischia di perdere proprietà in silenzio.

JSON-LD
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "Robots.txt and sitemaps",
  "datePublished": "2026-06-14",
  "author": { "@type": "Organization", "name": "DigestSEO" }
}
</script>
  • Un blocco per entità è più chiaro di un blocco gigante che prova a descrivere tutto ciò che sta nella pagina.
  • Generalo dagli stessi dati che rendono la pagina, così i due non possono divergere.
  • Può essere iniettato via JavaScript, ma la pagina deve comunque renderizzarsi bene perché il markup venga visto.

Il markup deve corrispondere alla pagina

Descrivere contenuti che un visitatore non può vedere è una violazione delle linee guida, non una scorciatoia. Google nomina esplicitamente entrambi i modi di sbagliare: pagine costruite come gusci vuoti per portare il markup, e proprietà che affermano fatti che la pagina non mostra mai. L'una o l'altra può costare del tutto il risultato avanzato, e un'azione manuale lo rimuove su tutto il sito, non solo su quella pagina.

La versione più comune non è deliberata. Un template emette una valutazione aggregata le cui recensioni sono state rimosse, o un prezzo che un selettore di valuta cambia lato client, o la data di un evento ormai passato. Nessuno voleva ingannare: il markup è semplicemente sopravvissuto al contenuto che descriveva. Per questo generarlo dai dati resi conta più che azzeccarlo una volta.

SintomoCausa abituale
L'arricchimento non è mai comparsoManca una proprietà richiesta, quindi la pagina non è idonea
È comparso e poi ha smessoIl contenuto è cambiato e il markup non gli corrisponde più
Markup valido, nessun arricchimentoIdonea ma non scelta: query, lingua o dispositivo
Arricchimento perso su tutto il sitoUn'azione manuale, segnalata in Search Console

Collegare le entità invece di ripeterle

La maggior parte dei siti finisce per descrivere la stessa organizzazione su ogni pagina, ogni volta con parole un po' diverse. Il vocabolario offre una risposta migliore della ripetizione: dai a un'entità un @id, definiscila una volta e fai riferimento a quell'identificatore ovunque altro.

La cosa conta oltre l'ordine. Un motore che concilia tre descrizioni sottilmente diverse della tua azienda deve decidere se siano un'organizzazione o tre; un identificatore esplicito gli toglie di mezzo l'ipotesi. Lo stesso vale per un'autrice che scrive su tutto il sito, o per un prodotto richiamato sia da un elenco sia da una recensione.

sameAs è l'altra metà. Punta ai profili e alle schede che già descrivono l'entità altrove: una voce di Wikipedia, un account ufficiale, un registro delle imprese. Non è una mossa di ranking, è corroborazione — proprio ciò che serve a un motore per collegare la tua affermazione su te stesso a qualcosa che può verificare.

Scegliere quali tipi aggiungere

Il filtro utile è breve: esiste una funzione di ricerca per questo tipo, e la pagina può davvero meritarsela? Marcare un tipo senza alcun risultato avanzato dietro aggiunge manutenzione e non cambia nulla nei risultati: il markup è valido, corretto e inerte.

Dichiarare un tipo che la pagina non giustifica è peggio che non aggiungere il markup, perché può violare le linee guida della funzionalità senza creare una presentazione utile nella ricerca. Un articolo guida non è un Product. Google ha smesso di mostrare i risultati avanzati delle FAQ il 7 maggio 2026 e a giugno ne ha rimosso la documentazione. È un promemoria del fatto che le funzionalità di ricerca possono essere ritirate. Contrassegna ciò che la pagina è davvero e consulta la raccolta delle funzionalità supportate prima di mantenere markup per una funzionalità di ricerca.

  1. Individua che cosa sia davvero la pagina, nei termini del vocabolario.
  2. Verifica se esiste una funzione di ricerca per quel tipo e che cosa richieda.
  3. Emetti ogni proprietà richiesta dai dati che rendono la pagina.
  4. Valida la sintassi, poi conferma l'idoneità nel rapporto sugli arricchimenti.
  5. Ricontrolla dopo le modifiche ai template: è lì che markup e contenuto divergono.

Provalo sul tuo sito

Domande e risposte

Quali tipi vale la pena aggiungere?

Quelli dietro cui c'è una funzione di ricerca che la tua pagina può davvero meritare. Marcare tipi senza risultato avanzato associato aggiunge manutenzione e non cambia nulla nei risultati.

Più markup posiziona meglio?

No. I dati strutturati non sono un fattore di ranking, e rivendicare tipi che la pagina non giustifica mette a rischio l'idoneità che avevi già.

Il markup è valido ma non compare nessun risultato avanzato. Perché?

La validazione prova che la sintassi è corretta, non che l'arricchimento comparirà. L'idoneità è il prerequisito; la comparsa dipende da query, dispositivo, paese e lingua, e dal giudizio di Google sull'utilità lì.

JSON-LD, Microdata o RDFa?

Tutti e tre sono accettabili e JSON-LD è il raccomandato. Sta in un unico tag script invece di essere infilato nel markup, quindi sopravvive alle modifiche dei template e resta leggibile per chi lo manterrà dopo.

I dati strutturati possono far penalizzare un sito?

Un markup che descrive contenuti che il visitatore non può vedere viola le norme antispam e può attirare un'azione manuale, che rimuove l'arricchimento su tutto il sito. La causa abituale non è l'inganno ma la deriva: un template che emette ancora una valutazione o un prezzo che la pagina non mostra più.