Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / HTML

poster — video preview image

The poster attribute on video specifies a preview image that the browser can display before video playback.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<video poster="image-url"></video>

The poster attribute on video identifies an image representing the video. Its value must be a valid, non-empty URL; relative addresses resolve against the document. It is not a boolean attribute or the video's address — that is what src specifies.

When video image data is unavailable, an available poster is displayed. An omitted attribute, empty value, or failed image fetch leaves no poster. Simply pausing playback does not guarantee that the poster reappears.

Examples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>poster</title>
<video width="320" height="180" controls
  poster="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='320' height='180'%3E%3Cpath fill='red' d='M0 0H320V180H0Z'/%3E%3C/svg%3E">
</video>
</html>

Result

A red 320 × 180 poster image; browser controls may overlay it. No playable video.

The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.

Sources