There aren't any special requirements for FV Player to work, and you don't need to install any additional plugins. This guide contains:


Here's a step-by-step guide to installing FV Player plugin to your website. Dont't forget that if you want to use all the advanced features that our player offers, buy a licence for FV Player Pro.

  1. Download and unpack the zip archive containing the plugin.
  2. Upload the fv-wordpress-flowplayer-master directory into wp-content/plugins/ directory of your WordPress installation.
  3. Navigate to Plugins in WordPress administration interface and activate FV Player.activate-fv-player
  4. Click both Check template and Check videos in the plugin settings screen at Settings -> FV Player to check if everything is running alright.
    Checker reports that everything is alright with our site

    If you see a warning about missing html5.js file saying "html5.js not found in your template!" check the section below.

  5. Optionally, if you want to embed videos denoted just by their filename, you can create the /videos/ directory directly in the web root of your domain and place your videos there. Otherwise, you would have to type in complete URL of video files.

Inserting a license key

If you have purchased our PRO extension, please insert your license key in the field at the top of the settings.


After you are done the message "Thank you for purchasing FV Player license" will appear. And now you are ready to set up your player and videos.

Switching to Beta in Pro version

If you have installed the Pro extension, you can now choose whether you want to use the newest Beta features or use the more stable Release version. Beta version lets you use new functions right after they are released, but beta means that they might still come with some issues. Switching between Beta and Release is not permanent and you can change it in the settings whenever you want.

To do this, go to Settings -> FV Player Pro and in the top left corner you'll see a drop-down list.


Adding missing html5.js file

When you hit the Check template button, you might see a warning about "html5.js not found in your template!". This JavaScript provides HTML5 tags compatibility for old Internet Explorer browsers. It's not absolutely required, but recommended for better compatibility.

Most modern WordPress templates already use this file, but if it's missing, you can grab it from html5shiv Google Code page. Click the download link, unpack the resulting ZIP file and then copy dist/html5shiv.js into your theme folder as html5.js and add the following code snippet into your header.php template before the closing </head> tag:

<!--[if lt IE 9]>
<script src="<?php echo get_template_directory_uri(); ?>/html5.js"></script>

Using FV Player with minify plugins

WP Minify

Before enabling WP Minify, we recommend that you run the template check and take care of any issues. Once you enable WP Minify, the default settings should be fine, but we recommend that you check a couple of your videos.

We don't recommend enabling "Place Minified JavaScript in footer" option of WP Minify.

wp minify default
Default WP Minify settings


Update: Autoptimize 2.0.2 seems to work, but you have to make sure these options in Settings -> Autoptimize are off:

  • Force JavaScript in <head>
  • Also aggregate inline JS

Server requirements

  1. Make sure that your video files use correct mime types. You can simply add the following code into your .htaccess file:

    AddType video/mp4             .mp4
    AddType video/webm            .webm
    AddType video/ogg             .ogv
    AddType application/x-mpegurl .m3u8
    AddType video/x-m4v           .m4v
    # hls transport stream segments:
    AddType video/mp2t            .ts 

    If you use NginX, this is handled in the config files.

  2. If you have PHP 4 or older version installed, you will see an error message like this:

    Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /... .../wp-content/plugins/fv-wordpress-flowplayer/models/flowplayer.php on line 4

    The plugin requires PHP 5 in order to run properly. Ask your hosting provider to upgrade to PHP 5, PHP 4 is just too old.

Fixing broken JavaScript

Logged in as site admin you might see the following warning instead of working videos:

Admin JavaScript warning:
I'm sorry, your JavaScript appears to be broken.

Here's how the warning looks like on our site in case JavaScript is not working:

foliovision com admin javascript check
Admin warning appearing instead of playable video to notify the site admin about JavaScript issues

We decided to have FV player display this warning, because we were receiving some complaints about our player not working, while the issue was on clients' websites actually. The website is an ecosystem, and if some part is broken, it might affect the rest of the site - even more when it comes to JavaScript. If you are facing this issue, then probably other plugins are not working properly as well, they just don't tell you about it.

The most common issues why this message appears are:

  1. There is a fatal JavaScript error on your site
    • You can find out what error is triggered by checking the JavaScript error console of your browser. Here's a handy tutorial on - Using Your Browser to Diagnose JavaScript Errors
    • The solution is to try to switch to a different theme (you can use theme preview) first. If that doesn't help, turn your WordPress plugins off one by one. If you think you found the conflicting plugin, or you think it's the fault of our plugin, do not hesitate to use our support forums
  2. Some library is not loading properly or at all (either jQuery or FV Player)
    • This is often a theme or plugin conflict (duplicate loading of jQuery, loading another version of FV player), although we work hard to avoid it. We also added an automated check for this in plugin settings, so that's the first place to look at.
    • If all the plugins used the WordPress API properly (namely wp_enqueue_scripts), there would be no issues.
    • The solution is to try to switch to a different theme (you can use theme preview) first. If that doesn't help, turn your WordPress plugins off one by one. If you think you found the conflicting plugin, or you think it's the fault of our plugin, do not hesitate to use our support forums
  3. Some blocking item is slow to load and it blocks the JavaScript execution
    • This might be the case with any external tracking or ad code which is not loading asynchronously. It means the item has to load before the browser continues rendering the page. Issue like this might be temporary, for example, if one of the external servers is overloaded.
    • We put our JavaScript into footer (the best practice), so if there is a slow to load external item above it, it might take a while for the browser to stop trying to load the external item and load the player.
    • The solution is to avoid external scripts, or always use scripts with asynchronous loading. We recommend to run your site through the Pingdom Full Page Test to see what request is slow and blocking the page to load.

If you are still having issues, please use our support forums. We also offer hands-on support, we are happy to help, just order our Pro support.

If you are a programmer, you might find our Troubleshooting Javascript Errors guide useful.