Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Adds an images tab to your pages so you can format a group of images really nicely on the frontend
Ruby JavaScript
Pull request Compare This branch is 4 commits ahead, 171 commits behind refinery:master.
Latest commit b304279 @ugisozols ugisozols Merge pull request #41 from javiercr/master
Added spanish translation.
Failed to load latest commit information.
app Adding ability to connect page images to anything. Mainly blogs though
config/locales Fixed small typos.
db/migrate Add migration which was missed in polymorphic
features Add basic features to test that the images tab appears when you use t…
public pt-BR translations
spec changes to specs, and testing for the existence of blog_post Added documentation for captions.
refinerycms-page-images.gemspec Only depend on refinerycms-pages >=, regenerated gemspec for …

Page Images Engine for Refinery CMS


Page Images allows you to relate one or more images to any page in Refinery which makes it really easy for you to create simple image galleries with lightbox style popups on the front end page views.


  • refinerycms >= 0.9.9


  • Ability to select one or more images from the image picker and relate them to a page
  • Reordering support, simply drag into order
  • Optionally include captions with each image.


Add this line to your applications Gemfile

gem 'refinerycms-page-images', '~> 1.0'

Next run

bundle install
rails g refinerycms_page_images
rake db:migrate

Now when you start up your Refinery application, edit a page and there should be a new "Images" tab.

If you get an error like

uninitialized constant Refinery::Pages::Tab

It means your Refinery version isn't new enough. To fix that you need to update the Refinery CMS Gemfile line to this

gem 'refinerycms', '~> 0.9.9'

Then run:

bundle install
rake refinery:update

And then try again. Note that doing this will likely mean that you need to fix your application for any changes that have happened since the version of Refinery CMS that you were using.

Enable Captions

Change the setting "Page Images Captions" to "true" to enable captions.



<% content_for :body_content_right do %>
  <ul id='gallery'>
    <% @page.images.each do |i| %>
        <%= link_to image_tag(i.thumbnail("200x200#c").url), i.thumbnail("900x600").url %>
    <% end %>
<% end %>
<%= render :partial => "/shared/content_page" %>


Refinery CMS Page Images Screenshot

Something went wrong with that request. Please try again.