Skip to content


Repository files navigation


This gem allows you to embed twitch channels, clips, collections, and videos in your Jekyll websites. It adds and registers a new twitch liquid tag that accepts a twitch clip, channel, broadcast, or highlight url. It's based on the Twitch video embeds.

{% twitch %}

Check out the demo site for install instructions and to review different embed examples.


Add this line to your application's Gemfile:

gem 'jekyll-twitch'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install jekyll-twitch

Then add Jekyll-Twitch to your _config.yml like so:

  - jekyll-twitch


This is a Jekyll liquid tag, so just put {% twitch %} to embed your clip, channel, or broadcast.

When building your site, Jekyll no longer substitutes site.url for localhost, which means Twitch embeds will not render. You need to supply host and localhost to view clips in development. jekyll serve --host localhost --port 4000

All of the below examples are on the demo site with actual embeds. I strongly recommend using that.


This channel embed will show the broadcast while the streamer is live, and the channel offline art when they are not.

<div style="width:720px;height:480px">
  {% twitch %}


This embed is used to add a collection of videos to your page or post.

<div style="width:720px;height:480px">
  {% twitch %}


This embed is used to add one Twitch clip to your page or post.

<div style="width:720px;height:480px">
  {% twitch %}


Whether you call them videos, vods, or higlights, this will embed them in your page or psot.

<div style="width:720px;height:480px">
  {% twitch %}


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

For more details on setting up the local environment, demo site, and releasing a new version, see our


The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the Jekyll::Twitch project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.