Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Responsive Video Gallery

I recently worked on a website redesign that needed a video gallery. It was a WordPress project and would contain videos from YouTube and Vimeo. I decided a custom post type and custom fields was the best approach, and what follows is the HTML5/CSS and jQuery app, Fancybox.

The code I wrote is open source and free to be copied, used, and changed.

Fancybox is Copyright Protected by Janis Skarnelis:

See the responsive video gallery

First write the HTML

<article class="video">
    <a class="fancybox fancybox.iframe" href="">
    <img class="videoThumb" src=""></a>
  <h2 class="videoTitle">Mesopotamia</h2>
  1. Use two classes: fancybox and fancybox.iframe on the a tag.
  2. Use the URL in the iframe embed code, not the copy & paste URL.
  3. Right click on the YouTube or Vimeo video thumbnail and copy the image URL for the source.
  4. Use your own class names for the article, img src, and video title.

Next is the CSS

/* First make sure the video thumbnail images are responsive. */

img {
  max-width: 100%;
  height: auto;

This is the starting grid for each video with thumbnails 4 across for the largest screen size.
It's important to use percentages or there may be gaps on the right side of the page. 

.video {
  background: #fff;
  padding-bottom: 20px;
  box-shadow: 0 1px 1px rgba(0, 0, 0, 0.15);
  width: 23%; /* Thumbnails 4 across */
  margin: 1%;
  float: left;

These styles keep the height of each video thumbnail consistent between YouTube and Vimeo. 
Each can have thumbnail sizes that vary by 1px and are likely break your layout. 

.video figure {
  height: 0;
  padding-bottom: 56.25%;
  overflow: hidden;

.video figure a {
  display: block;
  margin: 0;
  padding: 0;
  border: none;
  line-height: 0;

/* Media Queries - This is the responsive grid. */

@media (max-width: 1024px) {
  .video {
    width: 31.333%; /* Thumbnails 3 across */

@media (max-width: 600px) {
  .video {
    width: 48%; /* Thumbnails 2 across */

@media (max-width: 360px) {
  .video {
    display: block;
    width: 96%; /* Single column view. */
    margin: 2%; /* The smaller the screen, the smaller the percentage actually is. */
    float: none;

/* These are my preferred rollover styles. */

.video img {
  width: 100%;
  opacity: 1;

.video img:hover, .video img:active, .video img:focus {
  opacity: 0.75;
  1. The media query breakpoints are videos 4 across for sizes greater than 1024px, 3 across for sizes greater than 600px, and 2 across for sizes greater than 360px. At 360px the videos are no longer floated, but rather display:block in a single column.
  2. I like the widths and margins to be fluid with percentages for the responsive layout.
  3. It’s important to stretch the thumbnail image with width:100% on screen sizes that exceed the natural size of the image. When the screen size is smaller, the width of the article is smaller than the images's natural size, and max-width:100% takes over so the images are responsive.
  4. Styling the video titles are also important – if the titles are on top of, or below, the video, and are not consistent across each video, each article height will be different and break the layout.

Using Fancybox

// These can go in the footer.


  $(document).ready(function() {
      padding   	: 0,
      maxWidth  	: '100%',
      maxHeight 	: '100%',
      width   		: 560,
      height    	: 315,
      autoSize  	: true,
      closeClick  : true,
      openEffect  : 'elastic',
      closeEffect : 'elastic'
  1. Fancybox includes a style sheet you need to copy and paste into your CSS.
  2. First call the jQuery library from the jQuery CDN.
  3. Then initialize Fancybox.
  4. There's a lot of documentation on how to use Fancybox. You can check the docs on GitHub, on, and on


A simple responsive video gallery






No releases published


No packages published