O que é o schema VideoObject
VideoObject é um tipo de marcação do Schema.org criado para descrever o conteúdo de vídeo de uma página. Ele é incorporado ao HTML como JSON-LD e ajuda o Google a entender o conteúdo do vídeo sem precisar reproduzi-lo.
Sem o schema VideoObject, o Google ainda consegue descobrir e indexar os vídeos, mas com a marcação as chances de aparecer nos resultados avançados (carrosséis de vídeo, snippets aprimorados) são bem maiores.
Para vídeos do YouTube incorporados por iframe, o Google recebe os dados diretamente do YouTube. O schema VideoObject continua útil para enriquecer o contexto da página.
Campos obrigatórios do VideoObject
- name
- O título do vídeo. Deve coincidir com o título visível na página e no player.
- description
- Descrição textual do conteúdo do vídeo. Mínimo de 1 frase; o recomendado são de 2 a 5.
- thumbnailUrl
- URL da imagem de miniatura. Mínimo de 160×90 px. Precisa ser acessível para o Googlebot.
- uploadDate
- Data de publicação no formato ISO 8601 (por exemplo, 2026-05-26T10:00:00+03:00).
Campos recomendados do VideoObject
- contentUrl
- URL direta do arquivo de vídeo. Obrigatória para vídeos hospedados no seu servidor. Para o YouTube, use embedUrl.
- embedUrl
- URL do player incorporado (src do iframe). Para o YouTube: https://www.youtube.com/embed/VIDEO_ID.
- duration
- Duração no formato ISO 8601: PT4M30S = 4 minutos e 30 segundos. Exibida no snippet.
- expires
- Data em que o conteúdo do vídeo expira. Depois dessa data, o Google não mostra o vídeo nos resultados avançados.
- hasPart
- Trechos do vídeo com marcações de tempo (schema Clip), o que habilita os Momentos principais (Key Moments) nos resultados de pesquisa.
- interactionStatistic
- Número de visualizações. Tipo de interação: UserInteraction: WatchAction.
Exemplo de marcação VideoObject
A marcação é adicionada ao <head> ou ao <body> da página, dentro de uma tag <script type="application/ld+json">. Exemplo mínimo válido: { "@context": "https://schema.org", "@type": "VideoObject", "name": "Título do vídeo", "description": "Descrição do vídeo", "thumbnailUrl": "https://example.com/thumb.jpg", "uploadDate": "2026-05-26" }
Resultados avançados disponíveis com VideoObject
- Carrossel de vídeos: um grupo de resultados de vídeo na página de resultados para uma consulta sobre o tema
- Snippet aprimorado: miniatura e duração em um resultado comum
- Momentos principais (Key Moments): marcações de tempo com navegação pelas seções do vídeo (exige o schema Clip em hasPart)
- Selo Live: rótulo LIVE para transmissões ao vivo (campo BroadcastEvent)
FAQ
Todo vídeo do site precisa do schema VideoObject?
Recomendado para todos os vídeos que você quer promover na pesquisa. Se o vídeo for apenas um elemento de apoio da página, sem valor de pesquisa próprio, a marcação é opcional.
Como validar a marcação VideoObject?
Use o Google Rich Results Test (search.google.com/test/rich-results): cole a URL da página ou o código. A ferramenta mostra os campos detectados e os erros.
Por que o vídeo não aparece nos resultados avançados, mesmo com a marcação correta?
A marcação é necessária, mas não suficiente. O Google decide por conta própria se mostra os resultados avançados. Confirme que a miniatura é acessível para o Googlebot, que a página do vídeo pode ser indexada e que o conteúdo está atualizado.
Dá para adicionar o schema VideoObject em vídeos incorporados do YouTube?
Sim, e é recomendado. Embora o Google receba os dados do vídeo do YouTube diretamente, o schema VideoObject na sua página ajuda o Google a entender o contexto da página e a relacionar o vídeo ao tema dela.