Validatore di Schema Markup

Avanti

I dati strutturati che quasi si validano sono dati strutturati che falliscono in silenzio nel produrre un risultato avanzato. Incolla qui il tuo blocco JSON-LD e questo validatore conferma due cose all’istante: che viene analizzato come JSON valido e che include l’essenziale di cui ha bisogno ogni elemento di Schema.org: un @context, un @type e un name o headline. Pensalo come il controllo strutturale rapido che fai prima del Test dei risultati avanzati, più lento: individua la parentesi rotta o il tipo mancante in pochi secondi.

Come controllare il tuo schema markup

  1. 1

    Incolla il tuo JSON-LD

    Inserisci il blocco `<script type="application/ld+json">` completo o solo l'oggetto JSON che contiene: qualsiasi tag script viene rimosso automaticamente.

  2. 2

    Esegui il controllo

    Il validatore analizza il JSON e, se non riesce ad analizzarlo, ti indica l'errore di sintassi esatto da correggere.

  3. 3

    Leggi il risultato

    Conferma che le chiavi essenziali sono presenti (`@context`, `@type` e un `name` o `headline`) oppure elenca esattamente quali mancano.

  4. 4

    Correggi e ricontrolla

    Correggi il frammento e rieseguilo finché non risulta pulito, poi portalo al Test dei risultati avanzati di Google per le regole specifiche di ogni tipo.

Errori di validazione comuni e come risolverli

Quando porti il tuo markup a un validatore completo come il Test dei risultati avanzati di Google, la maggior parte dei fallimenti proviene dalla stessa breve lista di errori. Imparare a riconoscerli riduce drasticamente il tempo di debug.

Colpevoli frequenti

Messaggio di errore Cosa significa Come risolvere
Campo mancante “image” Campo richiesto omesso Aggiungi almeno un URL immagine (assoluto)
“datePublished” non è una data valida Formato errato Usa ISO 8601: 2026-04-18 o con ora+offset
Tipo sconosciuto “Offers” Maiuscole errate Usa Offer (singolare) all’interno di un array offers
Campo richiesto “price” mancante Prodotto senza prezzo Aggiungi price e priceCurrency nelle offerte
Il valore di “author” è una stringa Dovrebbe essere un oggetto Person/Organization Avvolgilo come { "@type": "Person", "name": "..." }
@id duplicato Stesso identificatore su due nodi Usa un @id unico per entità
reviewCount di 0 con aggregateRating Lo snippet delle stelle richiede almeno 1 recensione Rimuovi la valutazione o aspetta di avere recensioni
URL “/” (relativo) I parser richiedono URL assoluti Usa l’URL completo https://example.com/path

Avvisi vs errori

  • Gli errori significano che il risultato avanzato non è idoneo. Correggili per primi.
  • Gli avvisi significano idoneo, ma manca una proprietà che sbloccherebbe uno snippet più grande (ad es. aggiungere brand e sku a un Prodotto).

Suggerimenti per un markup affidabile

  • Controlla la struttura prima della validazione approfondita. Correggere qui una parentesi rotta o un @type mancante ti risparmia un viaggio di andata e ritorno tra gli strumenti specifici di ogni tipo, più lenti.
  • Mantieni il markup sincronizzato con il contenuto. Aggiornare il titolo della pagina senza aggiornare l’headline è il modo più veloce per essere segnalati per incoerenza.
  • Preferisci JSON-LD per la manutenibilità: un singolo blocco è più facile da controllare rispetto a proprietà sparse nell’HTML.
  • Monitora Search Console. Google registra errori e miglioramenti dei dati strutturati per tipo; controlla mensilmente.

Domande frequenti

No: significa che il tuo JSON-LD è ben formato e porta le chiavi essenziali. Un risultato avanzato richiede anche le proprietà obbligatorie specifiche del tipo, contenuti che corrispondano davvero al markup e le soglie di qualità di Google. Usa questo per correggere le basi in fretta, poi conferma l’idoneità nel Test dei risultati avanzati di Google.

Questo è un controllo strutturale leggero: conferma che il JSON venga analizzato e che @context, @type e un name o headline siano presenti. Il test di Google va oltre e valida le proprietà obbligatorie di ogni tipo idoneo. Esegui prima questo per eliminare gli errori evidenti, poi quello di Google per le regole specifiche di ogni tipo.

Sì: incolla il blocco <script type="application/ld+json">…</script> completo o solo l’oggetto JSON che contiene. I tag script che lo avvolgono vengono rimossi prima dell’analisi. Valida un blocco alla volta.

No. Il frammento viene inviato al nostro server solo per eseguire il controllo e viene scartato subito dopo; nulla di ciò che incolli viene salvato.

Strumenti correlati

Strumento disponibile in altre lingue