Qué es el esquema VideoObject
VideoObject es un tipo de marcado de Schema.org diseñado para describir el contenido de video de una página. Se inserta en el HTML como JSON-LD y ayuda a Google a entender el contenido del video sin tener que reproducirlo.
Sin el esquema VideoObject, Google puede seguir descubriendo e indexando los videos, pero con el marcado las probabilidades de aparecer en resultados enriquecidos (carruseles de video, fragmentos mejorados) son bastante mayores.
En los videos de YouTube incrustados mediante iframe, Google recibe los datos directamente de YouTube. El esquema VideoObject sigue siendo útil para enriquecer el contexto de la página.
Campos obligatorios de VideoObject
- name
- El título del video. Debe coincidir con el encabezado visible en la página y en el reproductor.
- description
- Descripción textual del contenido del video. Mínimo 1 frase; se recomiendan de 2 a 5.
- thumbnailUrl
- URL de la imagen en miniatura. Mínimo 160×90 px. Googlebot debe poder acceder a ella.
- uploadDate
- Fecha de publicación en formato ISO 8601 (por ejemplo, 2026-05-26T10:00:00+03:00).
Campos recomendados de VideoObject
- contentUrl
- URL directa del archivo de video. Es obligatoria para los videos alojados en tu servidor. En YouTube, usa embedUrl.
- embedUrl
- URL del reproductor incrustado (atributo src del iframe). En YouTube: https://www.youtube.com/embed/VIDEO_ID.
- duration
- Duración en formato ISO 8601: PT4M30S = 4 minutos y 30 segundos. Se muestra en el fragmento.
- expires
- Fecha en la que caduca el contenido del video. Después de esa fecha, Google no mostrará el video en los resultados enriquecidos.
- hasPart
- Clips dentro del video con marcas de tiempo (esquema Clip). Permite mostrar Momentos clave en los resultados de búsqueda.
- interactionStatistic
- Número de visualizaciones. Tipo de interacción: UserInteraction: WatchAction.
Ejemplo de marcado VideoObject
El marcado se añade al <head> o al <body> de la página, en una etiqueta <script type="application/ld+json">. Ejemplo mínimo válido: { "@context": "https://schema.org", "@type": "VideoObject", "name": "Título del video", "description": "Descripción del video", "thumbnailUrl": "https://example.com/thumb.jpg", "uploadDate": "2026-05-26" }
Resultados enriquecidos disponibles con VideoObject
- Carrusel de video: un grupo de resultados de video para una consulta temática en los resultados de búsqueda
- Fragmento mejorado: miniatura y duración en un resultado estándar
- Momentos clave: marcas de tiempo con navegación por las secciones del video (requiere el esquema Clip en hasPart)
- Distintivo LIVE: la etiqueta LIVE para las transmisiones en directo (campo BroadcastEvent)
FAQ
¿Hace falta el esquema VideoObject en todos los videos de un sitio?
Se recomienda en todos los videos que quieras promocionar en la búsqueda. Si el video es un elemento de apoyo de la página sin valor de búsqueda propio, el marcado es opcional.
¿Cómo se valida el marcado VideoObject?
Usa la Prueba de resultados enriquecidos de Google (search.google.com/test/rich-results): pega la URL de la página o el código. La herramienta mostrará los campos detectados y los errores.
¿Por qué el video no aparece en los resultados enriquecidos si el marcado es correcto?
El marcado es necesario, pero no suficiente. Google decide por su cuenta si muestra resultados enriquecidos. Comprueba que Googlebot puede acceder a la miniatura, que la página del video es indexable y que el contenido está actualizado.
¿Se puede añadir el esquema VideoObject a videos de YouTube incrustados?
Sí, y se recomienda. Aunque Google recibe los datos de los videos de YouTube directamente, el esquema VideoObject en tu página ayuda a Google a entender el contexto de la página y a relacionar el video con su tema.