While the main Player experience is controlled using the settings defined in your Player configuration, additional runtime customization is achievable using client-side parameters.

Check the dedicated guide to see how to add runtime Player parameters with each embed method of the Web SDK.

Guide: How to use runtime Player parameters

Parameters	Default	Description	Type
`video`	undefined	The ID of the video to load.	string
`playlist`	undefined	The ID of the playlist to load.	string
`aspectRatio`	undefined	The aspect ratio of the Player. Possible values: `16:9` `4:3` `1:1` `3:4` `9:16` or `inherit`	string
`customConfig`	undefined	Define advertising configuration by passing in keys and values. More details. E.g. `customConfig[key]=values`	object
`loop`	`false`	To set the video to loop. More details. Possible values: `true` or `false`	boolean
`mute`	`false`	Whether to mute the video or not. To note, enabling mute may impact monetization. The Player provides smart mute behavior, it tries to automatically start the video playback with sound. If this isn’t possible due to browser prevention, there is a fallback mechanism and the Player reattempts to play the video but with the sound set to mute. Possible values: `true` or `false`	boolean
`scaleMode`	`fit`	To adjust the player’s video focus. Possible values: `fit` `fill` `fillLeft` `fillRight` `fillTop` `fillBottom`	enum
`startTime`	`0`	Specify the time (in seconds) from which the video should start playing.	number

`video`

The ID of the video to load.

Type	default value
string	`undefined`

`playlist`

The ID of the playlist to load.

Type	default value
string	`undefined`

`customconfig`

Define advertising configuration by passing in keys and values. More details.

E.g. customConfig[key]=values

Type	default value
object	`undefined`

`scalemode`

To adjust the player’s video focus.

Possible values: fit fill fillLeft fillRight fillTop fillBottom

Type	default value
enum	`fit`

`mute`

Whether to mute the video or not. To note, enabling mute may impact monetization.

The Player provides smart mute behavior, it tries to automatically start the video playback with sound.

If this isn’t possible due to browser prevention, there is a fallback mechanism and the Player reattempts to play the video but with the sound set to mute.

Possible values: true or false

Type	default value
boolean	`false`

`startTime`

Specify the time (in seconds) from which the video should start playing.

Type	default value
number	`0`

`loop`

To set the video to loop. More details.

Possible values: true or false

Type	default value
boolean	`false`