JSON-LD

JSON-LD (JavaScript Object Notation for Linked Data) è un modo di rappresentare i dati strutturati come blocco JSON separato dentro un tag `<script>`. A differenza del markup inline (RDFa, Microdata), il JSON-LD non si mescola con i tag HTML, semplificando implementazione e manutenzione.

Cos'è il JSON-LD

Il JSON-LD è un formato di dati strutturati basato su JSON, sviluppato dal W3C. Descrive entità e relazioni sul web. In SEO, il JSON-LD si usa per incorporare il markup schema.org in una pagina web.

Perché Google consiglia il JSON-LD

  • Nessuna mescolanza con l'HTML — il markup non intasa i tag della pagina.
  • Più facile da mantenere — può essere generato dinamicamente (per esempio dal CMS).
  • Amico degli sviluppatori — il JSON valido è leggibile e debuggabile.
  • Supporta tutti i principali tipi schema.org per i rich result (Product, FAQ, HowTo, Article, ecc.).

Esempio di markup JSON-LD (Organization)

json
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "SEOhead",
  "url": "https://seohead.tech",
  "logo": "https://seohead.tech/logo.png",
  "sameAs": [
    "https://twitter.com/seohead",
    "https://www.linkedin.com/company/seohead"
  ]
}
</script>
Il JSON-LD va tipicamente in <head> oppure alla fine di <body>. Sono ammessi più script JSON-LD sulla stessa pagina (per esempio blocchi separati per Product, BreadcrumbList e Organization).

FAQ

Posso mescolare JSON-LD e markup inline?
Sì, Google supporta gli approcci misti. Tuttavia è consigliato un unico formato (JSON-LD) per semplicità e affidabilità.
Tutti i tipi schema.org sono supportati in JSON-LD?
Sì, tutti i tipi e le proprietà schema.org sono pienamente supportati. Alcuni rich result di Google richiedono addirittura JSON-LD.
Come valido il JSON-LD?
Usa il Google Rich Results Test, lo Schema Markup Validator di schema.org oppure il validatore di Yandex (per la loro ricerca).