HTMLVideoElement: poster property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

The poster property of the HTMLVideoElement interface is a string that reflects the URL for an image to be shown while no video data is available. If the property does not represent a valid URL, no poster frame will be shown.

It reflects the poster attribute of the <video> element.

Value

A string.

Examples

html
<video
  id="media"
  src="https://example.com/video.mp4"
  poster="https://example.com/poster.jpg"></video>

js
const el = document.getElementById("media");
console.log(el.poster); // Output: "https://example.com/poster.jpg"

Specifications

Specification

HTML
# dom-video-poster

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Feb 13, 2024 by MDN contributors.

View this page on GitHub • Report a problem with this content