
jekyll-livid
A Jekyll plugin that adds a {% livid %} Liquid tag for embedding Livid videos in a responsive iframe, with support for all of Livid's advanced embedding parameters.
jekyll-livid is a Jekyll plugin that lets you embed a Livid-hosted video with one tag. It outputs a clean, responsive iframe wrapper and passes any mix of Livid’s advanced embedding parameters straight to the player.
Demo
{% livid YEsVONDwAoi8 livid_logo=true title=false airplay=true chromecast=true pip=true speed=true quality_selector=true keyboard=true %}
Why This Exists
I like Livid as a Vimeo alternative. It’s more affordable, it’s better value for small organizations, and it fits the kind of work I do in local government and economic development. I wanted to embed Livid videos in Jekyll the same way I embed other media, with a clean tag instead of raw HTML dropped into my Markdown.
Source Code
- GitHub: github.com/jchance/jekyll-livid
- RubyGems: rubygems.org/gems/jekyll-livid
Installation
Add to your Gemfile:
gem "jekyll-livid", "~> 0.1.0"
Add to _config.yml:
plugins:
- jekyll-livid
Then run bundle install.
Styling
The plugin wraps the player in a div with the class livid-embed. It doesn’t add any spacing or layout styles, and that’s on purpose. Every site has its own type rhythm and spacing scale.
If the video sits too close to the content below it, add a rule to your site’s CSS:
.livid-embed {
margin-bottom: 32px; /* adjust to match your site's heading/paragraph spacing */
}
Usage
Basic embed:
{% livid VIDEO_ID %}
With parameters:
{% livid VIDEO_ID autoplay=true muted=true %}
{% livid VIDEO_ID color=ff0000 controls=false %}
{% livid VIDEO_ID t=30 %}
The video ID is the string of letters and numbers at the end of your Livid share URL (e.g. https://livid.com/watch/YEsVONDwAoi8 → ID is YEsVONDwAoi8).
Advanced Parameters
Every one of Livid’s advanced embedding parameters works:
| Parameter | Values | Notes |
|---|---|---|
autoplay |
true/false | All videos |
muted |
true/false | All videos |
loop |
true/false | All videos |
controls |
true/false | Pro/Premium |
color |
hex code (no #) |
Pro/Premium |
colors |
up to 4 comma-separated hex codes | Pro/Premium |
dnt |
true/false | Disables analytics. All videos. |
background |
true/false | No controls, loops, autoplay, muted. Pro/Premium. |
t |
seconds | Start position, appended as #t=N |
preload |
auto/metadata/none | All videos |
playsinline |
true/false | Mobile inline playback. All videos. |
fullscreen |
true/false | Pro/Premium |
pip |
true/false | Picture-in-picture. Pro/Premium. |
keyboard |
true/false | All videos |
livid_logo |
true/false | Pro/Premium |
title |
true/false | Pro/Premium |
share |
true/false | Pro/Premium |
speed |
true/false | Pro/Premium |
quality_selector |
true/false | Pro/Premium |
min_quality |
240p–4k | Pro/Premium |
max_quality |
240p–4k | Pro/Premium |
progress_bar |
true/false | Pro/Premium |
volume |
true/false | Pro/Premium |
cc |
true/false | Closed captions. Pro/Premium. |
chromecast |
true/false | Pro/Premium |
airplay |
true/false | Safari only. Pro/Premium. |
play_button_position |
auto/bottom/center | Pro/Premium |
transparent |
true/false | All videos |
custom_logo |
true/false | Pro/Premium |

