Component: Players and Embeds


Here you select a Player Template and Playlist, edit the Player menu, and get the embed code for web distribution.

Players > View All

To view all of your Players in table view, click on the "Players" link on the left navigation menu. To create a new Player, press the "New Player" button at the top of the page and fill in the fields as described below. You will be taken to a 4-step process consisting of the following steps:

1. General

2. Metadata

3. Menu

4. Embeds




Player > General

There are two main components to Players: Player Templates and a Playlist. Templates make it easier to store branding and style information for reuse in other Players. Templates can be created from the Dashboard. Playlists are a list of Titles used for playback within the Player. Like Templates, they are reusable in different Players and can be authored here or from the Dashboard.


Player Name

Enter a name for this Player. This name will be used whenever your player is shared (via the Email form, or when posting to a third-party social network site).



Select a Playlist for your player. Playlists determine which content will be presented in a player.

To learn more about creating a new Playlist, refer to the Playlist page.


Select a template for your player. Templates allow you to incorporate visual styles and branding to multiple sets of players.

To learn more about creating a new Player Template, refer to the Player Template page.

Player URL

Enter the URL of the page you will be embedding this Player on. All shares and embeds of this player will point to this URL if supplied, or to a fallback URL if omitted.

Note: This field is not required, but it is strongly suggested that you enter the URL you will be embedding the Player on. All Players in the MediaStorm Platform are expected to have a single canonical location at which they can be found when shared or embedded elsewhere, and entering this URL helps ensure that your website becomes the destination people come to in order to see your content hosted via the Platform.

Player Settings

Allow Embedding

Check this box to enable others to embed your video on their own website. Learn more about the embed functionality in the section on embeds below.

Allow Ads

Check this box to enable ads for this player. If enabled, ads will be shown for Titles that have pre-roll ads enabled in the Playlist. Note that this is only an option if you've supplied YuMe credentials in your Settings.

Allow Full Screen

Check this box to allow full screen playback of your video.

Disable Player

Disabling this player will disable all embeds created from it, including the default embed automatically created for you.

Player > Metadata

Player Image


The Player Image is used in various places to represent a Player, including when shared to Facebook or via the Email form within the player.


High-resolution, uncompressed version of the Player Image. Cut-downs will be created from this image as needed.

Player Description

This description is used in various places to represent the Player, including when shared to Facebook of via the Email form within the player.

It should summarize of the Player's content using as few words as possible, and you can either use the Project Brief from one of the Titles within this Player's Playlist, or enter your own custom description.

Author and Keywords

Author Name

The company or organization name whose content this player contains. Defaults to your Company Name as set in the Settings.

Author URL

The company or organization URL whose content this player contains. Defaults to your Company URL as set in the Settings.

SEO Keywords

Keywords entered here are used for advertisement targeting and search engine optimization. To enter a keyword, click into the gray box labeled “Keywords” and begin to type. Press enter when you have finished inputting your keywords. You can also enter keywords by copying and pasting a comma delimited list of words from any other text document.

To delete a keyword, click on the gray ‘x’ that appears next to the keyword. You can delete more than one keyword at a time by holding down the shift key, clicking on multiple keywords and the pressing backspace or delete. 



Player > Menu

The Player Menu is displayed on the left side of the Player when a user’s mouse rolls over a Project.

On the left hand side of the screen you will see an area where you can add, delete and reorder the Player’s Menu Sections. To the right you will see a Player housing a Playlist of Titles entered in the first step. Every time you modify the Menu Sections, you can refresh the Player to preview your changes. If no new changes have been made, the refresh button will be disabled. 

By default, every Project has an About Section auto-generated for it using information already entered during the previous steps in creating your Project.

 The About Section is composed of shortcodes: an easy way to dynamically include the content that you entered previously without having to type it all out. This allows you to switch out content depending on what Title is currently being played back in the Player. For example, a section using the shortcode [title_description] will display the corresponding description for whichever Title is currently playing. This flexibility also allows you to mix content authored on the Project level as well as the Title level.



You can also author custom Text sections by clicking 'Add Section' and selecting the 'Text' item. 



The text section is where your Project and Title information live. It is an open field where you can include HTML-formatted text of your choice. It can also be auto-populated by shortcodes using the information you authored in the Player > General, Player > Metadata,  and Title > General, Title > Metadata steps. Providing thorough information in this section enhances how well your Project is found in search engines. 

Section Name

This is the name that appears in the Player's Menu tab.


To use shortcodes, click on the “Show shortcodes” link and select the shortcode you want to use. You can also manually type out the shortcodes shown above.

Text sections are also where you add Purchase Items you've created for your Titles and Projects. You simply include the shortcodes '[title_purchase_items]' and '[project_purchase_items]' to add them to your player. Adding this Purchase Items allows you to include a storefront that travels with your Player no matter where the Project is shared or embedded.

Other sections you'll notice in your Player Menu are 'Transcripts' and 'Sign in'. Transcripts are included automatically if you've added them to the currently queued Title. 

Player > Embeds

This page lists all the Embeds created for this Player. By default, the first Embed for a newly-created Player is automatically created for you. You will see it titled “Default Embed” in the table on this page. To access this Embed’s details, click on the Embed name or hover over its row and click on the Edit link.




Creating a New Embed

To create a new Embed, click on the blue "Create New Embed" button in the Embed summary box. You will notice a new row in the Embeds table with the Embed name "(no name)." You can give it a different name by selecting this Embed to edit.

After selecting your Embed, you will be brought to a page showing all the information for this specific Embed, detailed below. This is where you can access the code to embed it onto a web page.


Embed Settings

Embed Name

This name is for internal use only, to help keep track of different embeds that can otherwise only be identified by their unique Embed Key.

Embed Key

This is an automatically-generated key that is unique to this Embed instance.

An instance is a single occurrence of your player and there is typically a single unique instance for each different page the player appears on. For example, the player used on your own site would be one unique instance, while an embed that is created by a user to be used on their own site would be an additional unique instance and so on.

Disable Embed

This controls whether or not this specific Embed instance is enabled. In addition to turning off all embeds for a specific Player via the Player settings, you're given more granular control to disable specific Embed instances here, which will not affect any other Embeds created from the same Player.

Allow Ads

This will override the Ad settings for the Player this Embed was created from.

Viewing an Embedded Player

To view a Player and see it as someone would see it if it were embedded, click the Open embed preview link. This will open a new page with a preview of this embed instance.


Player Summary

Some of the settings for the Player this Embed was created from is shown here for reference.


Embed Snippet

To embed the Embed instance of this Player on your website, paste this snippet within your page's HTML code in the desired location. The only requirement is that it exists somewhere between the opening and closing HTML <body> tags.

To turn on subtitles by default for this embed, check the "Force subtitles on" checkbox and choose a language. If the Titles within that Player contain subtitles they will be turned on by default in this Embed.

To force the playlist to show on the right-hand side of the Player -- rather than hide it behind a button -- check the "Force playlist shown" checkbox.




Embed Headers Snippet

In order for your content to be represented on Facebook and other third-part platforms as best as possible when someone shares the page your Player is embedded on, this Embed Headers Snippet must be pasted between your page's opening and closing HTML <head> tags.

The Player itself will not be embedded on Facebook due to Facebook's policies around HTML5 content, but the Player Image uploaded for this Player will show, along with the Player's Description entered earlier on the Player > Metadata step.

Note that when your Player's poster has been updated you will have to manually replace the existing Embed Headers Snippet on your page with the new one that will be generated here.



This table lists the URLs that this Embed instance has been embedded and viewed on, as well as the number times it has viewed from that location.


Deleting a Player

To delete a Player you must be in Player > View All mode. If you're not, select the “Players” link in the left navigation. Next, in the Player Column, hover over the Player name and select the red Delete button. Confirm to continue.



Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk