Lo schema markup dice alle macchine cosa significa il tuo contenuto. Ma il formato che usi conta. Puoi scrivere lo schema markup in tre linguaggi diversi: Microdata, RDFa e JSON-LD. La maggior parte del web usa Microdata perché è vecchio e facile. I sistemi AI preferiscono JSON-LD perché è pulito, strutturato e non ambiguo.
JSON-LD sta per JSON for Linking Data. È un formato inventato apposta per rendere i dati strutturati leggibili dalle macchine senza ingombrare il tuo HTML. Lo scrivi in un tag script separato. Il contenuto visibile resta pulito. I dati leggibili dalle macchine stanno nel loro blocco. I crawler AI leggono JSON-LD più in fretta e in modo più affidabile degli altri formati. Se vuoi che i tuoi contenuti siano citabili dai sistemi AI, JSON-LD è il modo per riuscirci.
Perché JSON-LD batte gli altri formati di schema
Microdata ha questo aspetto. Aggiungi attributi direttamente ai tag HTML:
<div itemscope itemtype="https://schema.org/Article">
<h1 itemprop="headline">Article Title</h1>
<p itemprop="description">Article summary.</p>
</div>
Funziona. Google lo legge. Ma il tuo HTML si riempie di attributi dello schema. Contenuto e metadati si intrecciano.
JSON-LD li separa del tutto:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"description": "Article summary"
}
</script>
Il tuo HTML resta pulito. I dati leggibili dalle macchine stanno nel loro tag script. I crawler AI preferiscono questa separazione. È più chiara. Ha meno probabilità di errori. Si legge più in fretta.
RDFa è un terzo formato, ma si usa raramente. È più complesso sia di Microdata sia di JSON-LD. Né Google né i sistemi AI lo preferiscono. Lascia perdere RDFa.
Come i sistemi AI leggono JSON-LD
Quando un crawler AI visita la tua pagina, fa due cose. Legge il contenuto HTML visibile. E analizza tutti i tag script JSON-LD che trova.
Il JSON-LD gli dice: questa pagina è un Article. È stata pubblicata in questa data. È stata scritta da questo autore. L'argomento principale è questo. C'è un'immagine a questo URL. Il numero di parole è questo. Tutti questi metadati aiutano il sistema AI a capire il contenuto più a fondo di quanto potrebbe dal solo testo.
Quando il sistema AI decide poi se citarti, usa quei metadati. Uno schema Article JSON-LD formattato bene, con data di pubblicazione, autore e immagine, viene citato più spesso dello stesso contenuto senza nessuno schema. I metadati provano che sei la fonte originale.
La struttura essenziale di JSON-LD
Ogni blocco JSON-LD ha tre parti fondamentali. @context dice al parser quale vocabolario usi (quasi sempre schema.org). @type gli dice che tipo di cosa stai descrivendo. Le proprietà descrivono gli attributi specifici.
Un semplice schema Article ha questo aspetto:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Your Article Title",
"description": "Your article summary",
"image": "https://yoursite.com/image.jpg",
"datePublished": "2026-04-17",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Your Brand",
"logo": {
"@type": "ImageObject",
"url": "https://yoursite.com/logo.jpg"
}
}
}
</script>
Quel blocco JSON-LD sta nell'head della pagina (o in qualsiasi punto del body). Dice al crawler tutto ciò che deve sapere sull'articolo.
Dove mettere JSON-LD nella pagina
La buona pratica è mettere JSON-LD nella sezione head del tuo HTML, sopra il contenuto visibile. Il crawler legge prima l'head, quindi ottiene i metadati dello schema prima ancora di iniziare a leggere il body.
Ma JSON-LD funziona in qualsiasi punto della pagina. Nell'head. Nel body. Prima del contenuto. Dopo il contenuto. Non importa. Finché il JSON è valido, i crawler lo troveranno e lo leggeranno.
Molte piattaforme di contenuti inseriscono JSON-LD nell'head in automatico quando compili i campi dei metadati. Scrivi un titolo, una descrizione e una data di pubblicazione nel tuo CMS. La piattaforma genera il JSON-LD da sola. Non lo scrivi a mano.
JSON-LD per i diversi tipi di contenuto
Article è il tipo di schema più comune, ma JSON-LD supporta molti tipi. Ogni tipo ha proprietà obbligatorie e facoltative diverse.
Schema FAQPage
Se la tua pagina ha una sezione di domande frequenti, usa lo schema FAQPage. Dice ai crawler AI esattamente dove sono le tue domande e risposte:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "JSON-LD is a structured data format that AI systems prefer."
}
},
{
"@type": "Question",
"name": "Where do I put JSON-LD?",
"acceptedAnswer": {
"@type": "Answer",
"text": "In the head or body of your HTML page."
}
}
]
}
</script>
Lo schema FAQPage aumenta la probabilità che i sistemi AI estraggano correttamente le tue domande e risposte.
Schema Product
Per un negozio online, usa lo schema Product:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Product Name",
"description": "Product description",
"image": "https://yoursite.com/product.jpg",
"brand": {
"@type": "Brand",
"name": "Your Brand"
},
"offers": {
"@type": "Offer",
"url": "https://yoursite.com/product",
"priceCurrency": "USD",
"price": "99.99"
}
}
</script>
Lo schema Product dice agli assistenti d'acquisto AI il prezzo esatto, la disponibilità e le caratteristiche del tuo prodotto.
Schema HowTo
Per le guide passo passo, usa lo schema HowTo:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Set Up JSON-LD",
"step": [
{
"@type": "HowToStep",
"name": "Step 1",
"text": "Add a script tag to your page head."
},
{
"@type": "HowToStep",
"name": "Step 2",
"text": "Write valid JSON inside the script tag."
}
]
}
</script>
Lo schema HowTo aiuta i sistemi AI a capire la sequenza e a estrarre i passaggi nell'ordine giusto.
Errori comuni con JSON-LD
L'errore più comune è un JSON non valido. JSON ha regole di sintassi rigide. Ogni stringa deve stare tra virgolette doppie. Dopo ogni proprietà ci vogliono i due punti. Ogni oggetto o elemento di un array va separato da una virgola. Dimentica una virgola e tutto il JSON si rompe.
Prova il tuo JSON prima di pubblicare. Usa uno strumento di validazione JSON. Incolla il tuo JSON-LD nel validatore e ti dirà se ci sono errori di sintassi.
Il secondo errore è usare il @type sbagliato. Se la tua pagina è un post di blog, usa Article, non BlogPosting. Se è un prodotto, usa Product, non Item. Il tipo conta perché i crawler capiscono la struttura in modo diverso in base al tipo.
Il terzo errore è dimenticare le proprietà obbligatorie. Lo schema Article richiede un headline. Lo schema Product richiede un prezzo. HowTo richiede almeno un passaggio. Controlla la documentazione di schema.org per ogni tipo per vedere cosa è obbligatorio e cosa facoltativo.
Validare e testare il tuo JSON-LD
Google ha uno strumento chiamato Rich Results Test. Incolli il tuo URL e ti mostra tutto il JSON-LD che ha trovato in quella pagina. Ti dice se il JSON è valido. Ti dice se mancano proprietà obbligatorie. Ti mostra come appaiono i dati letti.
Anche schema.org ha uno strumento di validazione. Incolli il tuo JSON-LD e ne valida la sintassi e la conformità allo schema.
La maggior parte dei CMS ha una validazione integrata. Se pubblichi contenuti con proprietà dello schema obbligatorie mancanti, il CMS ti avvisa prima della pubblicazione.
Domande frequenti
Mi serve JSON-LD se uso già Microdata?
No. Usa un formato o l'altro, non entrambi. Se usi Microdata e funziona, tienilo. Ma se imposti lo schema markup da zero, JSON-LD è la scelta migliore. È più pulito, più facile da mantenere e i sistemi AI lo preferiscono. Con il creatore di siti di WEMASY puoi impostare tutto direttamente sul tuo sito.
Posso avere più blocchi JSON-LD nella stessa pagina?
Sì. Puoi avere uno schema Article in un blocco e uno schema Organization in un altro. Puoi anche annidare gli schema. Per esempio, uno schema Article può contenere uno schema Person per l'autore. Più blocchi vanno bene finché ognuno è un JSON valido.
JSON-LD influisce sulla velocità del mio sito?
No. JSON-LD è solo testo. Non richiede nessuna elaborazione da parte del tuo server. Il crawler lo legge quando visita la pagina. Non c'è nessun impatto sulle prestazioni del tuo sito. È invisibile ai visitatori.
E se aggiorno il contenuto ma dimentico di aggiornare il JSON-LD?
I crawler AI leggeranno i vecchi metadati JSON-LD e il tuo contenuto visibile attuale. Potrebbero notare la differenza. Il titolo nel JSON-LD dovrebbe corrispondere al titolo visibile. La data di pubblicazione dovrebbe essere corretta. Se divergono in modo evidente, i crawler possono fidarsi più del contenuto visibile che dei metadati.
Devo usare JSON-LD per i link interni o solo per il contenuto principale?
Usa JSON-LD per ogni contenuto che vuoi far capire a fondo ai sistemi AI. Gli articoli principali ne traggono più vantaggio. Anche le pagine prodotto. Anche le pagine di domande frequenti. I semplici link di navigazione non hanno bisogno di JSON-LD. Concentra l'impegno sui contenuti che i sistemi AI potrebbero citare o consigliare.
I sistemi AI vedono il JSON-LD nascosto con CSS display:none?
Sì. I crawler AI leggono il JSON-LD indipendentemente dal fatto che sia visibile agli utenti. Non devi nasconderlo né mostrarlo. La maggior parte delle piattaforme mette JSON-LD nell'head, dove comunque non è visibile. Il crawler lo vede. È ciò che conta.