Dati strutturati: JSON-LD, verifica ed errori da evitare

I tipi che vale la pena avere

Google cita nella sua introduzione ai dati strutturati alcuni casi di grandi siti: Rotten Tomatoes ha registrato un CTR più alto del 25% sulle pagine con dati strutturati, Nestlé un CTR più alto dell'82% sulle pagine mostrate come risultati avanzati (Google Search Central). Sono risultati riportati da Google su siti molto grandi, non una previsione per il tuo. Per un sito aziendale o un negozio online di solito bastano questi tipi:

• Organization o un sottotipo di LocalBusiness (per esempio Restaurant o Store) nella home: nome, logo, URL, indirizzo, telefono, orari e link sameAs ai profili ufficiali.
• WebSite con il nome del sito, che aiuta Google a mostrare il nome giusto nei risultati.
• BreadcrumbList sulle pagine interne, per il percorso di navigazione nei risultati.
• Product con Offer (prezzo, valuta EUR, disponibilità) sulle schede prodotto, più spedizione e reso se li hai.
• Article o BlogPosting con autore e date sui contenuti editoriali.

Cosa è cambiato: FAQ, istruzioni e stelline delle recensioni

Già nell'agosto 2023 Google aveva ridotto i risultati avanzati di tipo Istruzioni (HowTo) e Domande frequenti (Google Search Central Blog). Poi ha chiuso del tutto il risultato FAQ: dal 7 maggio 2026 non compare più nella Ricerca Google per nessun sito (documentazione FAQPage).

Il markup FAQPage resta schema.org valido e può aiutare le macchine a leggere domande e risposte, ma non produce più le FAQ espandibili nei risultati: non aggiungerlo come tattica SEO.

Anche le stelline hanno un limite: se l'attività controlla le recensioni su se stessa e le pubblica sul proprio sito con markup LocalBusiness o Organization, quelle pagine non sono idonee alle stelle nei risultati (linee guida sulle recensioni).

Dati strutturati e risposte dell'AI

Per comparire nelle AI Overviews o in AI Mode Google dice che non servono dati strutturati schema.org speciali né nuovi file, e chiede che i dati strutturati corrispondano al testo visibile sulla pagina (Funzionalità di AI e il tuo sito web). Un markup corretto resta utile: dichiara senza ambiguità prezzi, sedi, orari e autori, e rende la pagina più facile da capire e da citare in modo esatto.

Errori che fanno ignorare il markup

• Markup su contenuti che la pagina non mostra, come recensioni o FAQ presenti solo nel JSON-LD. Le linee guida di Google lo vietano espressamente.
• Prezzi, valutazioni o disponibilità nel markup diversi da quelli visibili sulla pagina.
• Lo stesso blocco Organization copiato su ogni pagina con nome o logo diversi.
• JSON non valido: basta una virgola mancante per rendere illeggibile tutto il blocco.
• Tipo sbagliato: ogni pagina marcata come Product o FAQPage anche quando il contenuto visibile non corrisponde.
• Riferimenti incoerenti: canonical o valori @id che puntano a un'altra pagina o a un'organizzazione diversa.

Se Google rileva una violazione può applicare un'azione manuale: la pagina perde l'idoneità ai risultati avanzati, ma secondo le linee guida generali sui dati strutturati il suo ranking nella Ricerca non cambia.

Come verificarli

Prima controlla che il JSON-LD sia JSON valido. Poi verifica che il tipo scelto corrisponda alla pagina e che le proprietà richieste o consigliate trovino riscontro nel contenuto visibile. Infine prova l'idoneità con il Test dei risultati avanzati di Google, dove esiste un risultato avanzato per quel tipo. Una sintassi corretta, da sola, non rende la pagina idonea.

Il Test dei risultati avanzati mostra per quali risultati avanzati una pagina è idonea; lo Schema Markup Validator controlla la validità schema.org in generale. Dopo la pubblicazione, i report sui risultati avanzati in Search Console mostrano gli errori su tutto il sito e lo strumento Controllo URL conferma che Google ha trovato il markup.

L'analisi di Sitequiry rileva i tipi JSON-LD presenti sulla pagina analizzata e indica quali mancano tra quelli importanti per quel tipo di pagina.

Esempio: un blocco Organization con partita IVA

Un esempio per un'azienda inventata su example.com, da adattare e non da copiare così com'è. Se il sito mostra già la partita IVA, per esempio nel footer, puoi riportarla nella proprietà vatID con il prefisso IT: così il markup dice la stessa cosa del testo visibile. Quali dati un'impresa deve pubblicare sul proprio sito è una questione legale e fiscale, non di SEO: verificalo con il tuo commercialista o consulente. Aggiungi indirizzo, telefono o orari solo se la pagina li mostra.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://www.example.com/#organization",
  "name": "Esempio Studio S.r.l.",
  "url": "https://www.example.com/",
  "logo": "https://www.example.com/logo.png",
  "vatID": "IT00000000000",
  "sameAs": ["https://www.linkedin.com/company/esempio-studio"]
}

Domande frequenti