Contact UsTry it for free
© 2025 Direct Cursus Technology L.L.C.

Video player SDK for IFrame

Written by
Updated at November 28, 2025

You can embed a video player with content from Cloud Video to an HTML page using the video player SDK for IFrame.

To the page code, add the iframe embed code to display the player with the specified video:

<iframe
    frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=1"
></iframe>

Where:

Configuring the video player options

You can set the video size and player startup options.

Warning

If you adjust more than two settings at the same time, the video will be played back muted.

Video size

To specify video size, set the following parameters in the iframe tag: height for height and width for width.

Here is an example:

<iframe width="560" height="315" 
  frameborder="0"
    scrolling="no"
    allowfullscreen
    allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
    src="https://runtime.video.cloud.yandex.net/player/..."
></iframe>

To adjust the video to the container width, change the embed code as follows:

<div style="min-width: 100%">
  <div style="position: relative; padding-bottom: 56.25%; height: 0;">
    <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;"
        frameborder="0"
        scrolling="no"
        allowfullscreen
        allow="autoplay; fullscreen; encrypted-media; accelerometer; gyroscope; picture-in-picture; clipboard-write; web-share; screen-wake-lock"
        src="https://runtime.video.cloud.yandex.net/player/...?autoplay=1&mute=true"
    ></iframe>
  </div>
</div>

Player startup options

Customize your player appearance and video playback using special parameters.

Add parameter=value pairs separated by & to the embed code URL after ?:

https://runtime.video.cloud.yandex.net/player/...?param1=value1&...&paramN=valueN

You can see the list of parameters and their possible values in the table below. If you do not specify the parameters, the player will start with default parameters.

Parameter:

Description:

allow_muted

Auto video playback in mute mode at startup:

  • false: Muted autoplay not allowed.
  • true: Muted autoplay allowed.

The allow_muted parameter has priority over autoplay. If allow_muted=false, autoplay will take place only if it is possible with sound.

autoplay

Auto video playback at startup:

  • 0: Auto playback off.
  • 1: Auto playback on.

The default value is 0.

For the autoplay option to work correctly in all browsers, use the autoplay=1 parameter together with mute=1.

t

Time (in seconds) you want to start playback at.

The values range from 0 to video duration inclusive, e.g., t=30 (start playback at 30 seconds in).

If you do not specify this parameter, your video will play from the beginning, and live stream, from the current moment.

hidden

With this parameter, you can hide the player's interface elements. All of them are shown by default.

List of interface elements
  • *: All interface elements.
  • *,!<excluded_item>: All interface elements except the excluded one. For example, use *,!play to hide all interface elements except the play button.
  • contextMenu: Context menu.
  • fullscreen: Full screen toggle button.
  • live: Go back to live button.
  • mobileSeekButtons: Rewind and fast forward buttons in the mobile interface.
  • play: Interface element displaying the Play, Pause, and Repeat buttons. It turns off play or pause when clicking the player.
  • playbackRate: Playback rate.
  • poster: Poster.
  • preloader: Load indicator.
  • settings: Settings button.
  • startScreen: Start screen.
  • startScreenPlay: Play button on start screen.
  • subtitlesToggle: Subtitles toggle button.
  • timeline: Timeline. Disables rewinding and fast forwarding from the keyboard or by touching the sensor screen.
  • timelinePreview: Preview on the timeline.
  • time: Current playback time.
  • title: Video title.
  • sound: Mute button.
  • volumeSlider: Volume slider.

To hide several interface elements, provide a string of comma-separated values, e.g., hidden=startScreenPlay,play.

Note

We do not recommend using autoplay=0 and hidden=* together, since you cannot start a video with both.

lang

Player interface language.

List of languages
  • ru: Russian
  • en: English
  • be: Belarusian
  • id: Indonesian
  • kk: Kazakh
  • tr: Turkish
  • tt: Tatar
  • uk: Ukrainian
  • uz: Uzbek

If you do not specify the parameters or provide an unsupported value, the player interface language will be based on user data.

loop

Playback looping:

  • false: Playback looping off.
  • true: Playback looping on.

The default value is false.

mute

Mute at startup:

  • false: Sound on.
  • true: Sound off.

The default value is false.

object_fit

Scale the thumbnail to fit the screen size when loading a video:

  • contain: Keep the original thumbnail aspect ratio, no cropping.
  • cover: Resize the thumbnail to fill the entire frame by changing its aspect ratio or cropping.

The default value is cover.

play_on_visible

Stopping playback if the player leaves the visible area and starting playback if the player is in it. The parameter affects both video content and ads. It can take the following values:

  • false: Video is played back if the player leaves the visible area.
  • true: Video is not played back if the player leaves the visible area.
  • Player visibility ratio sufficient for playback. Specify this value as a decimal fraction with a period (.) for a delimiter.

The default value is false. When set to true, the visibility ratio is 0.5.

Note

When set to play_on_visible=true, the autoplay parameter is ignored. The parameter only works in browsers that can accurately calculate player visibility.

preload

Video preload:

  • false: Video preload off.
  • true: Video preload on.

The default value is false.

When set to autoplay=1, the preload parameter is ignored.

volume

Volume at startup.

The values range from 0 to 1 inclusive, e.g., volume=0.5.

If set to mute=1, the parameter is ignored.

background_color

Background color of the player and widgets.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

widget_text_color_primary

Color of widget body text.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

widget_text_color_secondary

Color of auxiliary widget text.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

widget_accent_color

Accent color of widget text.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

playlist_selected_item_background_color

Background color of an active playlist element.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

player_color

Color of the player interface elements, i.e., the loading indicator, time scale, and play button on the start screen with autoplay=0.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

widget_block_separator_color

Color of widget section separators.

Supports all colors in HEX format consisting of three and six characters as well as standard HTML color names.

player_border_radius

Rounding of the player section corners.

The default value is 3.

playlist_item_border_radius

Rounding of the playlist element corners.

The default value is 3.

widget_block_gap

Padding between the player and playlist section.

The default value is 0.

playlist_item_gap

Padding between playlist elements.

The default value is 10.

See also

Out-of-the-box video layout solutions in IFrame

Previous
Overview
Next
iOS