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, keyboard controls, or our player SDK to start and control playback. 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
|
|
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.
|