Simple preroll plugin for video.js
JavaScript HTML CSS
Switch branches/tags
Nothing to show
Clone or download
damianvila and dirkjanm Cross-compatible plugin register (#26)
* Cross-compatible plugin register

Modified plugin register code for cross-compatibility with Video.js 5
and 6.
Latest commit 68a6f1a Oct 28, 2017

Video.js Simple Prerolls

Simple video.js plugin that uses the video.js' videojs-contrib-ads plugin to display a preroll video before the main video starts.


This plugin requires video.js 5.0 or newer with videojs-contrib-ads 3.0 or newer. For users migrating from version 0.2.0, make sure your configuration style matches the one below.

Adding the plugin

Download the videojs-contrib-ads plugin or build it yourself from the repository. Include and videojs-preroll after including video.js itself.

<script src="video.js"></script>
<script src=""></script>
<script src="videojs-preroll.js"></script>
<link href="video-js.css" rel="stylesheet" type="text/css">
<link href="" rel="stylesheet" type="text/css">
<link href="videojs-preroll.css" rel="stylesheet" type="text/css">

Initialize the plugin:

<video id="example_video_1" class="video-js vjs-default-skin" controls width="640" height="264" poster="">
  <source src="" type='video/mp4' />
  <source src="" type='video/webm' />
  <source src="" type='video/ogg' />
videojs('example_video_1', {}, function(){
  var player = this;

There's also a working example of the plugin you can check out if you're having trouble.


Plugin Options

You may pass in an options object to the plugin upon initialization. This object may contain any of the following properties:


Type: String | Object | Array

Required. Source video file to play. Can be any valid videojs src parameter


Type: String

Url to redirect to if user clicks on the ad. Can be left empty for no redirection.


Type: String Default: _blank

Target to open the url in (eg _blank or _top).


Type: Boolean Default: true

Allow the user to skip the ad when it has played for a number of seconds.


Type: Integer Default: 5

Number of seconds after which the video can be skipped.


Type: Boolean Default: false

Whether the ad should be repeated if a new src is loaded to the player.


Type: Boolean Default: false

Adds an "Advertisement" sign to the video.


Type: Boolean Default: false

Show the remaining time of the ad (only if allowSkip is set to false.)


Type: Object Default: {}

Settings object passed to the videjs-contrib-ads plugin.


Type: Object Default:

    'skip in': 'Skip in ',
    'advertisement': 'Advertisement',
    'video start in': 'Video will start in: '

Language strings for skip button, "Advertisement" sign and remaining ad time element.


Uses javascript and css for video skipping and linking block from The Onions videojs-vast-plugin

Release History


  • Added cross-compatibility with Video.js version 5 and 6


  • Added "Advertisement" sign option
  • Added remaining time sign option
  • Modified loadingSpinner behavior to use native hide/show functions
  • Added loadingSpinner show, bigPlayButton hide and posterImage hide to exitPreroll to provide loading status feedback to user


  • Updated videojs-contrib-ads library to v3.0.0 and made the preroll plugin compatible with it
  • Changed plugin for video.js v5.0.0
  • Added language to config
  • Changed the recommended setup to ensure videojs-contrib-ads loads properly
  • Fixed issue when preload was set to "none" which caused the player to require another click on the play button


  • Updated videojs-contrib-ads library to v0.5.0 and made the preroll plugin compatible with it
  • Fixed some of the loading events to start playback faster if there is no ad to be displayed


  • Initial release