Glossario

Cosa sono i dati strutturati JSON-LD?

8 febbraio 2026 Aggiornato il 19 apr 2026

JSON-LD (JavaScript Object Notation for Linked Data) è un formato di dati strutturati che permette ai motori di ricerca di capire meglio di cosa parlano realmente le tue pagine. Invece di limitarsi a indovinare in base al contenuto HTML, i motori di ricerca possono leggere un blocco JSON-LD e sapere esattamente se una pagina descrive una ricetta, un prodotto, un'attività locale o un articolo di notizie. Il formato usa un blocco <script type="application/ld+json"> incorporato nel tuo HTML, invisibile ai visitatori ma completamente leggibile dalle macchine.

Cosa dicono i dati strutturati ai motori di ricerca

Considera i dati strutturati come uno strato di traduzione tra il tuo sito e Google. La tua pagina può menzionare "49,99" da qualche parte nel testo, ma senza dati strutturati Google non ha idea se si tratta di un prezzo, una valutazione o solo un numero casuale. JSON-LD elimina questa ambiguità mettendo il tuo contenuto in campi chiaramente etichettati che seguono il vocabolario Schema.org.

Google usa queste informazioni per diversi scopi:

  • Rich snippet: risultati di ricerca migliorati che mostrano valutazioni a stelle, prezzi, tempi di preparazione, risposte FAQ o date di eventi direttamente sulla pagina dei risultati. Questi si distinguono visivamente tra gli elenchi regolari e tipicamente attirano più clic.
  • Knowledge Graph: quando Google compone quei pannelli informativi sul lato destro dei risultati di ricerca (per aziende, persone o luoghi), i dati strutturati sono una delle fonti principali da cui attinge.
  • Ricerche vocali e assistenti: Google Assistant e strumenti simili estraggono risposte dai dati strutturati. Se la tua pagina FAQ ha il corretto markup JSON-LD, le tue risposte possono essere lette ad alta voce agli utenti.
  • Google Shopping e annunci Merchant: i dati strutturati dei prodotti possono essere inclusi negli annunci gratuiti dei venditori nei risultati Google Shopping, rendendoti visibile senza pagare per la pubblicità.

JSON-LD versus Microdata versus RDFa

Ci sono tre modi per aggiungere dati strutturati a una pagina web, e tutti raggiungono lo stesso obiettivo, ma in pratica funzionano in modo molto diverso:

  • JSON-LD: un blocco di script autonomo, tipicamente posto nell'<head> o alla fine del <body>. Non tocca affatto il tuo markup HTML. Puoi aggiungerlo, modificarlo o rimuoverlo senza influire sul layout visivo della tua pagina. Google raccomanda ufficialmente questo formato.
  • Microdata: attributi aggiunti direttamente ai tuoi elementi HTML (itemscope, itemprop, ecc.). Questo significa che i tuoi dati strutturati sono intrecciati con il codice del tuo template, il che lo rende più difficile da mantenere e si rompe più facilmente quando cambi il tuo tema.
  • RDFa: simile a Microdata in quanto usa attributi HTML, ma segue una specifica diversa. È più comune in contesti non Google ed è meno ampiamente supportato dai plugin WordPress.

Per i siti WordPress, JSON-LD è il chiaro vincitore. Mantiene puliti i tuoi template, funziona bene con i plugin di caching e può essere generato dinamicamente da PHP senza modificare i file del tuo tema.

Tipi Schema.org comuni per siti WordPress

Schema.org definisce centinaia di tipi, ma solo una manciata è tipicamente rilevante per i siti WordPress. Di seguito i tipi che incontrerai più spesso:

  • Article / BlogPosting: usato su articoli di blog e articoli di notizie. Contiene titolo, autore, data di pubblicazione e immagine in evidenza. È il tipo più usato sui siti WordPress e può attivare rich result in stile articolo su Google.
  • FAQPage: contrassegna pagine con contenuto domanda-risposta. Quando Google lo rileva, snippet FAQ espandibili possono essere visualizzati direttamente nei risultati di ricerca, il che può aumentare significativamente lo spazio occupato dal tuo annuncio.
  • HowTo: per tutorial o contenuto passo-passo. Google può visualizzare i singoli passi nei risultati di ricerca, a volte con immagini per ogni passo.
  • Product: essenziale per i negozi WooCommerce. Contiene prezzo, disponibilità, recensioni e marchio. Questo rende possibili rich result in stile prodotto con prezzi e valutazioni a stelle.
  • LocalBusiness: per aziende con una sede fisica. Contiene indirizzo, orari di apertura, numero di telefono e coordinate geografiche. Questo alimenta Google Maps e i risultati di ricerca locali.
  • BreadcrumbList: descrive il percorso di navigazione verso la pagina corrente. Google usa questo per visualizzare link breadcrumb nei risultati di ricerca invece dell'URL grezzo, il che è più ordinato e aiuta gli utenti a comprendere la struttura del tuo sito.
  • WebSite: posizionato sulla homepage, questo tipo può attivare un campo di ricerca sitelinks su Google, permettendo agli utenti di cercare nel tuo sito direttamente dalla pagina dei risultati di ricerca.

Come i plugin SEO WordPress generano JSON-LD

La maggior parte dei proprietari di siti WordPress non scrive JSON-LD a mano. Invece, i plugin SEO lo gestiscono automaticamente:

  • Yoast SEO: genera un graph JSON-LD esteso su ogni pagina, inclusi i tipi WebSite, WebPage, Organization (o Person), Article e BreadcrumbList. Yoast costruisce un graph connesso in cui tutte le entità si riferiscono l'una all'altra, dando a Google un quadro completo del tuo sito.
  • Rank Math: offre una generazione automatica simile ma fornisce anche un'interfaccia utente con cui puoi aggiungere tipi di schema personalizzati ai singoli post. Puoi contrassegnare un post come Recipe, Event o Course senza scrivere codice.
  • Schema Pro e altri plugin specializzati: se hai bisogno di un controllo più fine (ad esempio per aggiungere più tipi di schema a una pagina o per gestire strutture annidate complesse), i plugin di schema specializzati offrono quella flessibilità.

Un punto importante da tenere a mente: non usare più plugin che generano JSON-LD contemporaneamente. Dati strutturati duplicati o in conflitto confondono i motori di ricerca e possono far sì che nessuno dei tuoi rich snippet venga visualizzato.

Un esempio pratico JSON-LD

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "What is JSON-LD?",
  "author": {
    "@type": "Person",
    "name": "John Doe"
  },
  "datePublished": "2025-01-15",
  "dateModified": "2025-03-10",
  "publisher": {
    "@type": "Organization",
    "name": "Example Site",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "image": "https://example.com/article-image.jpg",
  "description": "A comprehensive guide to JSON-LD structured data."
}

Nota come tutto sia incluso in un blocco indipendente. Puoi incollarlo in qualsiasi pagina senza modificare un solo elemento HTML, e i motori di ricerca capirebbero immediatamente che la pagina descrive un articolo scritto da John Doe.

Testare e validare i tuoi dati strutturati

Prima di fare affidamento sui tuoi dati strutturati per generare rich result, dovresti validarli. Google offre due strumenti per questo:

  • Rich Results Test (search.google.com/test/rich-results): inserisci un URL o incolla il tuo codice, e Google mostra per quali tipi di rich result sei idoneo e se ci sono errori o avvisi.
  • Schema Markup Validator (validator.schema.org): un validatore più generale che controlla il tuo markup rispetto alla specifica Schema.org completa, non solo la parte che Google supporta.

Esegui questi controlli dopo aver apportato modifiche alle impostazioni del tuo plugin SEO o dopo aver cambiato tema. Le modifiche al tema a volte possono rimuovere o duplicare blocchi di dati strutturati.

Effetto sul tasso di clic

Il vantaggio pratico dei dati strutturati è una migliore visibilità nei risultati di ricerca. Le pagine con rich snippet occupano più spazio visivo sulla pagina dei risultati e offrono più informazioni a colpo d'occhio. Studi e report del settore mostrano costantemente che i rich result possono aumentare i tassi di clic del 20-30% rispetto agli annunci semplici. In particolare, gli snippet FAQ possono raddoppiare l'altezza del tuo risultato di ricerca, spingendo i concorrenti più in basso. Anche se la tua posizione di ranking rimane la stessa, una maggiore prominenza visiva significa più clic.

Detto questo, Google non garantisce rich result per ogni pagina con dati strutturati. Dipende dalla qualità del tuo contenuto, se Google si fida del markup e da quanto è competitiva la query di ricerca.

Cosa controlla InspectWP

InspectWP scansiona il tuo sito WordPress per blocchi JSON-LD con dati strutturati e segnala quali tipi Schema.org sono presenti. Controlla se le tue pagine contengono i tipi più comuni (Article, BreadcrumbList, WebSite) e segnala le pagine in cui i dati strutturati mancano completamente. Questo ti permette di identificare lacune nel tuo markup e assicurarti che il tuo plugin SEO generi l'output corretto su tutto il sito.

Controlla subito il tuo sito WordPress

InspectWP analizza il tuo sito WordPress per problemi di sicurezza, problemi SEO, conformità GDPR e prestazioni — gratuitamente.

Analizza gratis il tuo sito