Impostazioni cookie

I cookie necessari tengono il sito funzionante. La statistica mostra quali pagine sono utili. Puoi cambiare scelta in qualsiasi momento dal footer.

Cookie policy di questo sito — tutti i dettagli: categorie di cookie, come salviamo la tua scelta nel browser e come revocare il consenso.

Necessari

Funzioni di base del sito e la tua scelta di consenso. Sempre attivi.

Analisi

Aiuta a capire come viene usato il sito. Caricato solo dopo il tuo consenso.

GitHubScarica lo ZIP

Schema VideoObject

Lo schema VideoObject è un tipo di markup Schema.org in formato JSON-LD incorporato in una pagina con video. Descrive il video in modo leggibile dalle macchine: nome, descrizione, miniatura, durata e data di caricamento.

Cos'è lo schema VideoObject

VideoObject è un tipo di markup Schema.org progettato per descrivere i contenuti video di una pagina. Si incorpora nell'HTML come JSON-LD e aiuta Google a capire il contenuto del video senza doverlo riprodurre.

Senza schema VideoObject Google può comunque scoprire e indicizzare i video, ma con il markup le probabilità di comparire nei rich result (caroselli video, snippet avanzati) sono molto più alte.

Per i video YouTube incorporati via iframe, Google riceve i dati direttamente da YouTube. Lo schema VideoObject resta utile per arricchire il contesto della pagina.

Campi obbligatori di VideoObject

name
Il titolo del video. Deve coincidere con l'intestazione visibile in pagina e nel player.
description
Descrizione testuale del contenuto del video. Minimo 1 frase; consigliate 2-5.
thumbnailUrl
URL dell'immagine miniatura. Minimo 160×90 px. Deve essere accessibile a Googlebot.
uploadDate
Data di pubblicazione in formato ISO 8601 (per esempio 2026-05-26T10:00:00+03:00).
contentUrl
URL diretto del file video. Obbligatorio per i video ospitati sul tuo server. Per YouTube usa embedUrl.
embedUrl
URL del player incorporato (iframe src). Per YouTube: https://www.youtube.com/embed/VIDEO_ID.
duration
Durata in formato ISO 8601: PT4M30S = 4 minuti e 30 secondi. Mostrata nello snippet.
expires
Data di scadenza del contenuto video. Dopo questa data Google non mostrerà più il video nei rich result.
hasPart
Clip dentro il video con timestamp (schema Clip): abilita i Key Moments nei risultati di ricerca.
interactionStatistic
Numero di visualizzazioni. Interaction type: UserInteraction: WatchAction.

Esempio di markup VideoObject

Il markup si aggiunge in <head> o <body> della pagina in un tag <script type="application/ld+json">. Esempio valido minimale: { "@context": "https://schema.org", "@type": "VideoObject", "name": "Video Title", "description": "Video description", "thumbnailUrl": "https://example.com/thumb.jpg", "uploadDate": "2026-05-26" }

Rich result disponibili con VideoObject

  • Carosello video: un gruppo di risultati video nella SERP per una query tematica
  • Snippet avanzato: miniatura + durata in un risultato standard
  • Key Moments: timestamp con navigazione tra le sezioni del video (richiede lo schema Clip in hasPart)
  • Live Badge: etichetta LIVE per le dirette (campo BroadcastEvent)

FAQ

Serve lo schema VideoObject per ogni video del sito?
Consigliato per tutti i video che vuoi promuovere nella ricerca. Se il video è un elemento di supporto della pagina senza valore di ricerca autonomo, il markup è facoltativo.
Come validare il markup VideoObject?
Usa il Google Rich Results Test (search.google.com/test/rich-results): incolla l'URL o il codice della pagina. Lo strumento mostra i campi rilevati e gli errori.
Perché il video non compare nei rich result nonostante il markup corretto?
Il markup è necessario ma non sufficiente. Google decide in autonomia se mostrare i rich result. Verifica: miniatura accessibile a Googlebot, pagina del video indicizzabile e contenuto attuale.
Si può aggiungere lo schema VideoObject per i video YouTube incorporati?
Sì, ed è consigliato. Anche se Google riceve direttamente i dati dei video YouTube, lo schema VideoObject in pagina aiuta Google a capire il contesto e a collegare il video al suo tema.