Adding a TV Rating Watermark to a Flash Player V3 (Deprecated)

Add a TV rating watermark to assets using player parameters and custom metadata in Backlot.

Important: Ooyala Player V3 is deprecated and is scheduled to be disabled on 2018-01-31. After that date, Player V3 will no longer play your video or audio content. Customers still using Player V3 need to migrate to Player V4 (see Migrating from Player V3 and Player Migration FAQ).

Note: This feature is only available for Flash desktop.

Ooyala Flash player is now FCC compliant for displaying TV ratings associated with broadcast content. TV ratings are applied at the asset level, and each asset can only have one TV rating. The TV rating watermark appears when the video starts playing and will appear again when the video resumes after ad playback.

Note: The TV rating watermark will not appear during ad playback.

Custom Metadata to Add to Backlot per Asset

Populate the following metadata in Backlot as custom metadata for each asset you want to give a TV rating watermark.

Custom Metadata Description Valid Values Required Example
tvrating Specifies audience ratings or recommended audience.


Where X can be one of the following: Y | Y7 | G | PG | 14 | MA

Go to the FCC site to see descriptions of each rating.

Yes tvrating: “TV-PG”

Specifies content label or nature of content.

Note: tvsubratings can only be applied to Y7, PG, and 14 TV ratings.

V | S | L | D | FV
  • V: violence
  • S: sexual situations
  • L: coarse or crude indecent language
  • D: suggestive dialogue FV: fantasy violence

Note: For multiple sub ratings, values should be comma or semicolon separated with no spaces between values.

No tvsubratings:




A click through URL. A URL link. No tvratingurl= ""

Player Parameters

Apply the following parameters at the page level.

tvRatingsTimer: This required parameter specifies the duration of the TV rating watermark on the player (in seconds) on initial play and every time the video resumes from Ad breaks. The default value of this parameter is "never", but other valid values include "always" and "some_number".
  • always: The watermark appears for the duration of the video (but will not appear during ad playback).
  • never: The watermark never appears.
  • some_number: You will replace some_number with the number of seconds you want the TV rating to remain on the player.

tvRatingsPosition: This optional parameter specifies the position on the player where the TV rating will appear. By default this value is set to "top-left", but other valid values include "top-right", "bottom-left", and "bottom-right".


The following example shows how to set the tvRatingsPosition and tvRatingsTimer player parameters.

var player = OO.Player.create('playerwrapper', embedCode, {
    tvRatingsPosition: "top-left",
    tvRatingsTimer: "15"

Was this article helpful?