Animated previews

Adds an animated image showing a preview snippet of the VOD content.


If you are not a Flowplayer platform customer, you need to generate a compatible animation from your video to work with the plugin.

Currently supported formats:

  • image/gif
  • image/webp


Load the animated previews plugin next to the core player.

<script src="//"></script>
<script src="//"></script>

Player and plugins exist in different release versions. Please see the release channel documentation.

OVP managed player

To enable the plugin in the OVP managed async player, declare it in the "plugins": [] config object with preview.


If you are using a video form Flowplayer platform that has animated previews generated you don't need to configure anything additional. The player will request the preview information alongside other metadata from the platform API.

For manually created previews you need to configure the player to pick up the previews.

You configure the plugin with top level configuration option preview.

To support animated previews the player also needs to be configured with a poster image configuration. Otherwise the preview plugin will not be activated.

The configuration option is a configuration object with properties:

  • trigger - what to use to trigger playback of the animation. Values are bitmasks taken from the flowplayer.preview.trigger enumeration. Possible keys:
    • MOUSEOVER - When the mouse is hovering the player. This is the default for desktop browsers.
    • VIEWPORT_VISIBLE - When the player is in or enters the viewport.
    • MOBILE_VIEWPORT_VISIBLE - When the player is in or enters the viewport on mobile devices. This the default for mobile browsers.
  • src - URL of the animated file to use for the preview. When configuring multiple previews this is an array of objects with src, type, and dimension properties (description below).
  • type - MIME type of the file. Only image/* supported for now.
  • dimensions - optional dimensions of the preview. Object with keys width and height that represent numbers of pixels. Usefull if you configure src as an array to support responsive previews.

    An example configuration overriding the default trigger would be:

    preview: {
    src: "<url of image>",
    type: "image/webp",
    trigger: flowplayer.preview.trigger.VIEWPORT_VISIBLE

Example code and demo

const previews = [ { src: "", type: "image/webp", dimensions: { width: 640, height: 360, }, }, { src: "", type: "image/webp", dimensions: { width: 480, height: 270, }, }, { src: "", type: "image/webp", dimensions: { width: 1280, height: 720, }, }, ] flowplayer("#player", { src: "//", poster: "//", preview: { trigger: flowplayer.preview.trigger.MOUSEOVER, src: previews } })