Skip to content
Thumbnail generation with Dragonfly
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Middleman Dragonfly Thumbnailer

Middleman Dragonfly Thumbnailer is a Middleman extension that lets you easily create thumbnails using Dragonfly's fantastic thumb processor.


Add this line to your application's Gemfile:

gem 'middleman-dragonfly_thumbnailer'

And then execute:

$ bundle

Or install it yourself as:

$ gem install middleman-dragonfly_thumbnailer


Just add the following to your config.rb file:

activate :dragonfly_thumbnailer


<%= thumb_tag 'image.png', '100x100#', class: 'thumbnail' %>
<%= thumb_tag 'image.gif', '100x100#', format: 'jpg', frame: 1, class: 'thumbnail' %>

The second argument is a geometry string which specifies the dimensions and options such as aspect ratio and cropping. You can also change the output format and choose the frame for GIFs. Have a look at for examples of what you can do. Any other options will be passed to the image_tag helper.

When running Middleman in development, thumbnails will be generated on the fly and encoded in data URLs.

During a build, the thumbnails will be saved next to original image in a sub directory named using the geometry string, so the thumbnail for images/image.png will be saved as images/100x100/image.png.


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


Copyright (c) 2018 Andrew White. MIT Licensed, see LICENSE.txt for details.

You can’t perform that action at this time.