VideoObject schema (разметка видео)

VideoObject — тип разметки Schema.org для видеоконтента. Позволяет Google понять содержание видео и отображать его в виде rich results: карусели, превью и расширенные сниппеты в выдаче.

Кратко

VideoObject schema — разметка типа Schema.org в формате JSON-LD, встраиваемая на страницу с видео. Описывает видеоролик машиночитаемым образом: название, описание, thumbnail, длительность, дата загрузки.

Что такое VideoObject schema

VideoObject — тип разметки Schema.org, предназначенный для описания видеоконтента на странице. Встраивается в HTML в формате JSON-LD и помогает Google понять содержание видео без необходимости его воспроизводить.

Без VideoObject schema Google всё равно может обнаружить и проиндексировать видео, но с разметкой шансы на попадание в rich results (видеокарусели, расширенные сниппеты) значительно выше.

Для YouTube-видео, встроенных через iframe, Google получает данные напрямую с YouTube. VideoObject schema при этом всё равно полезна для обогащения контекста страницы.

Обязательные поля VideoObject

name
Название видео. Должно совпадать с заголовком видео на странице и в видеоплеере.
description
Текстовое описание содержания видео. Минимум 1 предложение, рекомендуется 2–5.
thumbnailUrl
URL изображения-обложки. Минимум 160×90 px. Обязательно должен быть доступен для Googlebot.
uploadDate
Дата публикации в формате ISO 8601 (например, 2026-05-26T10:00:00+03:00).
contentUrl
Прямой URL видеофайла. Необходим для видео, hosted на вашем сервере. Для YouTube используйте embedUrl.
embedUrl
URL встроенного плеера (iframe src). Для YouTube: https://www.youtube.com/embed/VIDEO_ID.
duration
Длительность в формате ISO 8601: PT4M30S = 4 минуты 30 секунд. Отображается в сниппете.
expires
Дата истечения актуальности видео. После этой даты Google не показывает видео в rich results.
hasPart
Клипы внутри видео с временными метками (Clip schema) — открывают Key Moments в выдаче.
interactionStatistic
Количество просмотров. Тип UserInteraction: WatchAction.

Пример разметки VideoObject

Разметка добавляется в <head> или <body> страницы в теге <script type="application/ld+json">. Пример минимальной корректной разметки: { "@context": "https://schema.org", "@type": "VideoObject", "name": "Название видео", "description": "Описание видео", "thumbnailUrl": "https://example.com/thumb.jpg", "uploadDate": "2026-05-26" }

Rich results, доступные с VideoObject

  • Видеокарусель: группа видеорезультатов в выдаче по тематическому запросу
  • Расширенный сниппет: превью + длительность в стандартном результате
  • Key Moments: временные метки с навигацией по частям видео (требует Clip schema в hasPart)
  • Live Badge: пометка LIVE для прямых трансляций (поле BroadcastEvent)

Частые вопросы

Рекомендуется для всех видео, которые вы хотите продвигать в поиске. Если видео — вспомогательный элемент страницы и не несёт самостоятельной ценности для поиска, разметка не обязательна.
Используйте Google Rich Results Test (search.google.com/test/rich-results) — вставьте URL страницы или код. Инструмент покажет обнаруженные поля и ошибки.
Разметка — необходимое, но не достаточное условие. Google сам решает, показывать ли rich results. Убедитесь: thumbnail доступен для Googlebot, видеостраница индексируема, контент актуален.
Да, и это рекомендуется. Хотя Google получает данные о YouTube-видео напрямую, VideoObject schema на вашей странице помогает Google понять контекст страницы и связать видео с её темой.
Прямые контакты

Обсудим ваш проект?

Расскажите о целях и сайте — предложу формат работы и следующий шаг.