Advanced embedding parameters
Livid's advanced embed parameters let users fine-tune every aspect of the player via URL parameters, including colors, controls, autoplay, captions, and more.
Override a single videos look and feel with per video parameters:
|
Parameter
|
Supported Values
|
Default Value
|
Description
|
Supported Videos
|
|---|---|---|---|---|
|
airplay
|
true, false OR 1,0
|
true
|
Whether AirPlay is enabled.
|
Video must be hosted by a Pro account. ⚠️Note: AirPlay is only supported on Safari.
|
|
autoplay
|
true, false OR 1,0
|
false
|
Automatically start playback of the video.
|
All videos
|
|
background
|
true, false OR 1,0
|
false
|
Adding this parameter will:
1. Disable all player controls (including play/pause). 2. Set the video to loop. 3. Set the video to autoplay. 4. Mute the video's audio. To prevent looping or autoplay, use the autoplay=0 and loop=0 parameters. Setting this parameter will not disable keyboard controls. |
Video must be hosted by a Pro account.
|
|
controls
|
true, false OR 1,0
|
true
|
Hides or reveals all player elements, such as the playbar and sharing buttons, to create a chromeless experience.
Note: When disabled, the play/pause button is hidden. Viewers must use autoplay, or keyboard controls. This setting does not disable keyboard controls. |
Video must be hosted by a Pro account.
|
|
cc
|
true, false OR 1,0
|
true
|
Whether the closed captions button is enabled.
|
Video must be hosted by a Pro account.
|
|
chromecast
|
true, false OR 1,0
|
true
|
Whether the Chromecast button appears.
|
Video must be hosted by a Pro account. ⚠️Note: Chromecast is not supported on iOS
|
|
color
|
[hex code]
|
Livid indigo - 4e48f9
|
Specify the color of the video controls. Colors may be overridden by the embedded settings of the video.
If color is not set via parameter or setting, the default parameter will activate. |
Video must be hosted by a Pro account.
|
|
colors
|
1-4 [hex codes] - comma separated. (Example: colors=0a0a0a,4e48f9,ffffff,000000)
|
Color 1 - Buttons: #0a0a0a Color 2 -Accent: #4e48f9 Color 3 -Icon and text: #fffff Color 4 - Background: #000000
|
Specify the colors of the player. Colors may be overridden by the embedded settings of the video.
|
Video must be hosted by a Pro account.
|
|
custom_logo
|
true, false OR 1,0
|
Value specified in the video’s settings on site
|
Show the custom logo image.
|
Video must be hosted by a Pro account.
|
|
dnt
|
true, false OR 1,0
|
false
|
Setting this parameter to "true" blocks the player from collecting session data and analytics, similar to activating a Do Not Track feature in your browser.
|
All videos.
|
|
fullscreen
|
true, false OR 1,0
|
true
|
Whether the fullscreen button appears.
|
Video must be hosted by a Pro account.
|
|
keyboard
|
true, false OR 1,0
|
true
|
Allows for keyboard input to trigger player events. If false, the player will ignore keyboard input. Tabbing will still be supported in either mode.
|
All videos
|
|
livid_logo
|
true, false OR 1,0
|
true
|
Whether the Livid logo appears.
|
Video must be hosted by a Pro account.
|
|
loop
|
true, false OR 1,0
|
false
|
Play the video again when it reaches the end, infinitely.
|
All videos
|
|
muted
|
true, false OR 1,0
|
false
|
Set the video to mute on load. Viewers can still adjust the volume preferences in the player. Can be used to unmute background videos or work around autoplay limitations in certain browsers, such as Chrome and Safari.
|
All videos
|
|
pip
|
true, false OR 1,0
|
true
|
Show the picture-in-picture button in the control bar and enable the picture-in-picture API.
|
Video must be hosted by a Pro account.
|
|
play_button_position
|
auto, bottom, or center
|
auto
|
Where the play button is positioned on the player. When set to auto, the play button appears in the control bar before moving to the center of the player on smaller breakpoints.
|
Video must be hosted by a Pro account.
|
|
playsinline
|
true, false OR 1,0
|
true
|
Play video inline on mobile devices instead of automatically going into full-screen mode. Inline playback is enabled by default for all videos.
|
All videos
|
| preload | auto, metadata, none | none |
The player's pre-playback loading behavior aligns with the native preload property of the HTMLMediaElement interface: - Use "auto" to load metadata and the first few seconds of video right away. - Use "metadata" to load only the video's metadata immediately. - Use "none" to prevent any data loading until playback starts. Preloading more data helps the video start faster. Therefore, "auto" leads to quicker startup, but requires more bandwidth since video segments load whether the user plays the video or not. |
All videos |
|
progress_bar
|
true, false OR 1,0
|
true
|
Whether the progress bar appears.
|
Video must be hosted by a Pro account.
|
|
quality_selector
|
true, false OR 1,0
|
true
|
Whether the quality selector menu appears.
|
Video must be hosted by a Pro account.
|
|
share
|
true, false OR 1,0
|
true
|
Whether the share button appears.
|
Video must be hosted by a Pro account.
|
|
speed
|
true, false OR 1,0
|
true
|
Display speed controls in the player's preference menu
|
Video must be hosted by a Pro account.
|
|
#t
|
Time represented in seconds (for example, #t=25)
|
Start of video (0)
|
Used to automatically begin playback at a specific point in time.
|
All videos
|
|
title
|
true, false OR 1,0
|
true
|
Show the video’s title.
|
Video must be hosted by a Pro account.
|
|
transparent
|
true, false OR 1,0
|
true
|
The Livid player's iframe background is transparent by default. If disabled, the background will change to black. Black bars will be visible on the player when the iframe's height and width don't match the video's original aspect ratio, such as setting the iframe to 4:3 while the original video is 16:9.
|
All videos
|
|
volume
|
true, false OR 1,0
|
true
|
Whether the volume control appears.
|
Video must be hosted by a Pro account.
|
| min_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto | The lowest quality the player will automatically switch to during video playback. The player selects the optimal quality without falling below this threshold. Setting this parameter helps ensure viewers receive high-resolution video while considering bandwidth constraints. You can select any quality option available in the player, including 360p, 720p, 1080p, and 4K. | Video must be hosted by a Pro account. |
| max_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto | The highest quality the player will automatically select during video playback. The player chooses the best quality up to this value without exceeding it. Setting this can help reduce bandwidth consumption. You can select any value from the quality menu in the video player, including 360p, 720p, 1080p, and 4K. | Video must be hosted by a Pro account. |
| initial_quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto | The initial video quality, shown briefly before adaptive streaming starts. This is adjustable for faster loading or better clarity. Lower quality, like 360p, loads faster; higher quality, like 1080p or 4K, offers better resolution immediately. | Video must be hosted by a Pro. |
| quality | 240p, 360p, 540p, 720p, 1080p, 2k, 4k | auto | By default, the Livid player is set to "Auto" mode, meaning it chooses the highest possible video quality based on the viewer's bandwidth and other factors in the playback environment. Quality lets you specify the default playback resolution for your embedded video. If you select a quality that isn’t available, the parameter will be ignored, and the embed will default to Auto. | Video must be hosted by a Pro. |