Example of a video in search results with a live badge

The livestream feature adds a live badge to video thumbnails in search results. In order for the badge to appear, we'll need to know whether the video is live or when the stream begins. The live badge can be applied to any public video that is live streamed for any duration of time. Here are a few examples:

  • Sporting events
  • Awards shows
  • Influencer videos
  • Live streaming video games


Here's an example of VideoObject and isLiveBroadcast using JSON-LD code.


You must follow these guidelines for your content to be eligible to display as a rich result with a live badge:

Content guidelines

  • Don't use vulgar or potentially offensive language in the structured data.

Structured data type definitions

You must include the required properties for your content to be eligible for display as a rich result. You can also include the recommended properties to add more information about your content, which could provide a better user experience.


The full definition of VideoObject is available at

Required properties


A URL pointing to the actual video media file.



The description of the video.



A URL pointing to a player for the specific video. Usually this is the information in the src element of an <embed> tag.



The title of the video.


Repeated field of ImageObject or URL

A URL pointing to the video thumbnail image file.

추가 이미지 가이드라인

  • 모든 페이지에는 마크업 포함 여부와 관계없이 하나 이상의 이미지가 있어야 합니다. Google에서 가로세로 비율과 해상도를 기반으로 검색결과에 표시할 최적의 이미지를 선택합니다.
  • 이미지 URL은 크롤링 및 색인 생성이 가능해야 합니다.
  • 이미지가 마크업된 콘텐츠를 나타내야 합니다.
  • 이미지는 .jpg, .png 또는 .gif 형식이어야 합니다.
  • 최상의 결과를 위해서는 가로세로 비율이 16x9, 4x3, 1x1인 여러 개의 고해상도 이미지(너비와 높이의 곱이 최소 50,000픽셀)를 제공하세요.


"image": [



The date the video was first published, in ISO 8601 format.



Describes when the video is to be streamed live. Can be a list or a single instance.

Recommended properties


The duration of the video in ISO 8601 format.



If applicable, the date after which the video will no longer be available, in ISO 8601 format. Don't supply this information if your video does not expire.



The number of times the video has been viewed.


The full definition of BroadcastEvent is available at BroadcastEvent properties must be included inside the VideoOject entity.

Required properties


Time and date of when the livestream ends or is expected to end, in ISO 8601 format.

It is required to provide the endDate once the video has finished and is no longer live. If the expected endDate is unknown prior to the livestream starting, we recommend providing an approximate endDate.

If endDate is in the past or present, it indicates stream actually ended and is no longer live. If endDate is in the future, it indicates stream is scheduled to end at that time.



Set to true if the video is, has been, or will be streamed live.



Time and date of when the livestream starts or is expected to start, in ISO 8601 format. If startDate is in the past or present, it indicates that the stream actually started. If startDate is in the future, it indicates stream is scheduled to start at that time.

Update Google quickly with the Indexing API

We recommend using the Indexing API to ensure that Google crawls your livestream quickly. Call the API for the following events:

  • When the video goes live
  • When the video has stopped streaming, and the page's markup has been updated to indicate the endDate
  • Whenever a change has happened in the markup and Google needs to be notified

다음에 대한 의견 보내기...