Document: pictureInPictureEnabled property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The read-only pictureInPictureEnabled property of the Document interface indicates whether or not picture-in-picture mode is available.

Picture-in-Picture mode is available by default unless specified otherwise by a Permissions-Policy.

Although this property is read-only, it will not throw if it is modified (even in strict mode); the setter is a no-operation and will be ignored.

Value

A boolean value, which is true if a video can enter picture-in-picture and be displayed in a floating window by calling HTMLVideoElement.requestPictureInPicture(). If picture-in-picture mode isn't available, this value is false.

Examples

In this example, before attempting to enter picture-in-picture mode for a <video> element the value of pictureInPictureEnabled is checked, to avoid making the call if the feature is not available.

js
function requestPictureInPicture() {
  if (document.pictureInPictureEnabled) {
    videoElement.requestPictureInPicture();
  } else {
    console.log("Your browser cannot use picture-in-picture right now");
  }
}

Specifications

Specification
Picture-in-Picture
# ref-for-dom-document-pictureinpictureenabled

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
pictureInPictureEnabled

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

See also