Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An extendable Ruby on Rails CMS that supports Rails 3.2 and 4.1
Ruby HTML CSS JavaScript
branch: master

Merge pull request #2935 from refinery/design/flat

Restyled big orange site bar buttons to remove orange.
latest commit ca100e1634
@parndt parndt authored
Failed to load latest commit information.
authentication Update friendly_id to fix #2904
bin Loading spring for bin/rails doesn't work in the root
config Added spring support for slightly faster development.
core Restyled big orange site bar buttons to remove orange.
doc/guides Expose S3 configuration more directly, per #2921
images Happy 2015 everyone. Updated Copyright year and Resolve's website
lib Initial removal of the dashboard extension.
pages Fix menu links to absolute URLs.
resources Resources: Update resource_params, integrate changes requested by @pa…
spec Move HtmlHelpers to spec/ and use it in core specs also.
tasks Removed `rake refinery:testing:specs` and fixed `rake spec`.
templates/refinery Switched back to the master branch for merging
testing Apply fix to controller macros suggested by parndt
tmp/pids Add tmp/pids folder.
.gitignore Ignore text files
.pullreview.yml Fix Malformed PullReview conf file
.rspec Randomly order specs.
.travis.yml run CI headless
.yardopts Initial removal of the dashboard extension.
Gemfile Use routing-filter gem.
Rakefile Update Rails 3.2 -> Rails 4.0 APIs. Documented changes for #2734 Allow use of webserver Added `bundle exec` to make examples consistent Happy 2015 everyone. Updated Copyright year and Resolve's website Remove section on Dashboard from the readme.
refinerycms.gemspec Removed hard dependency on Bundler.. not sure it's required.

Refinery CMS

An open source content management system for Rails 4.1+

More information at

Build Status Code Climate Coverage Status

You can chat with us using Gitter:

Gitter chat


How to

Getting Started

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

If you want to use Rails 4.1.x with Refinery now, install using this template:

rails new app_name -m

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 Pages UI

Wanna see Refinery for yourself? Try the demo.

Help and Documentation



  • Easily edit and manage pages with a visual editor.
  • Manage your site's structure.

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.

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.