Skip to content
This repository

An extendable Ruby on Rails CMS that supports Rails 3.2 and 4.0

branch: master

Merge pull request #2388 from Rakoth/master

Possible fix for previewing pages with inherited templates.
latest commit 5d2de24afe
Philip Arndt parndt authored
Octocat-spinner-32 authentication we made it to 2014 February 18, 2014
Octocat-spinner-32 bin Updated script/rails to bin/rails September 03, 2013
Octocat-spinner-32 core Merge pull request #2388 from Rakoth/master April 15, 2014
Octocat-spinner-32 dashboard we made it to 2014 February 18, 2014
Octocat-spinner-32 doc Merge remote-tracking branch 'weedySeaDragon/2544-gemspec-author-note… April 15, 2014
Octocat-spinner-32 images Add dragonfly image strip process for compatibility February 27, 2014
Octocat-spinner-32 lib We call them *extensions* now and not *engines* February 29, 2012
Octocat-spinner-32 pages Merge pull request #2388 from Rakoth/master April 15, 2014
Octocat-spinner-32 resources we made it to 2014 February 18, 2014
Octocat-spinner-32 spec Use en locale in tests. January 08, 2014
Octocat-spinner-32 tasks Simplify a bit. March 30, 2012
Octocat-spinner-32 templates Removes protected_attributes from Gemfile in edge template January 25, 2014
Octocat-spinner-32 testing Remove httparty from test from 3277e67 April 15, 2014
Octocat-spinner-32 tmp Add tmp/pids folder. June 12, 2012
Octocat-spinner-32 .gitignore Added ability to use a .gemfile to specify dependencies that only I/y… March 30, 2012
Octocat-spinner-32 .rspec Randomly order specs. November 26, 2013
Octocat-spinner-32 .travis.yml Test Ruby 2.1.0. December 28, 2013
Octocat-spinner-32 .yardopts Fixed yard integration by specifying not to parse the templates direc… October 26, 2011
Octocat-spinner-32 Gemfile Moved away from protected_attributes/attr_accessible to strong_parame… January 16, 2014
Octocat-spinner-32 Rakefile Update Rails 3.2 -> Rails 4.0 APIs. September 03, 2013
Octocat-spinner-32 Add release date for 2.1.2. March 14, 2014
Octocat-spinner-32 Allow use of webserver March 30, 2012
Octocat-spinner-32 Remove a limitation on making Pull Requests August 18, 2013
Octocat-spinner-32 we made it to 2014 February 18, 2014
Octocat-spinner-32 Show Travis build status icon only for master branch. August 15, 2013
Octocat-spinner-32 refinerycms.gemspec Re-evaluate dependencies and bundle without development group on CI. December 14, 2012

Refinery CMS

An open source Ruby on Rails content management system for Rails 3.

More information at

Build Status Code Climate


How to

Getting Started

If you're new to Refinery, start with this guide:

What's it good at?

Refinery is great for sites where the client needs to be able to update their website themselves without being bombarded with anything too complicated.

Unlike other content managers, Refinery is truly aimed at the end user making it easy for them to pick up and make changes themselves.

For developers

  • Easily customise the look to suit the business.
  • Extend with custom extensions to do anything Refinery doesn't do out of the box.
  • Sticks to "the Rails way" as much as possible; we don't force you to learn new templating languages.
  • Uses jQuery for fast and concise Javascript.

Refinery Dashboard

Wanna see Refinery for yourself? Try the demo

Help and Documentation



Images & Files

  • Easily upload and insert images.
  • Upload and link to resources such as PDF documents.
  • Uses the popular Dragonfly.
  • Supports storage on Amazon S3.


  • Get an overview of what has been updated recently and see recent inquiries.

Authentication & Users

  • Manage who can access Refinery.
  • Control which extensions each user has access to.
  • Uses the popular Devise.

Custom Extensions

Extend Refinery easily by running the Refinery extension generator. For help run the command without any options:

rails generate refinery:engine

Popular Extensions

  • Blog - A simple blogging extension that supports posts, categories and comments with optional moderation support.
  • Portfolio - manage groups of images like an image gallery.
  • News - post and manage news items.
  • Inquiries - simple contact form that notifies you and customer when an inquiry is made.

Full extension list here

Example Site Showcase

List here (add your link when you're done)


See and Contributing to Refinery guide for details about contributing and running test.


Refinery is released under the MIT license. See the file for details.


Many of the icons used in Refinery CMS are from the wonderful Silk library by Mark James.

Something went wrong with that request. Please try again.