Embedding Media

Embedding various media objects like Youtube videos, Instagram pictures, Vines or Tweets is as easy as it could possibly be. The reason for this is a custom Kirbytext Tag (similar to a WordPress Shortcode or BBCode) that kirbyBOOK provides out of the box.

To add one of the various supported media objects to your page, all you need to do is to use the (embed) Kirbytext tag and add the url of the object you would like to embed to it.

Here are some highlights of the long list of sites you can embed from (full list):

  • Amazon
  • Dribbble
  • Flickr
  • gfycat
  • GitHub
  • Imgur
  • Instagram
  • Kickstarter
  • PollDaddy
  • SoundCloud
  • Spotify
  • Twitch.tv
  • Vimeo
  • Vine
  • Wikipedia
  • YouTube

To make using oEmbed as painless as possible, kirbyBOOK heavily relys on a service called Embedly Cards. It takes your media urls and generates the beautiful and responsive embeds you like so much asynchronously (without affecting page load times).


When using the(embed) Kirbytext tag, there is a small set of options you can use to customize the display of the embedded images/videos/articles.

Option Default Options Description
chrome no yes, no Show/hide a left hand colored border
controls no yes, no Show/hide social share buttons
width 100% any % or px based value Set the width of the embed
width center left, center, right Alignment of the embed