An extendable Ruby on Rails CMS that supports Rails 5.2+
Clone or download
brigriffin and parndt Add Matomo open web analytics (#3405)
This adds the possibility for a site to use the Matomo open web analytics (a.k.a. Piwik) for their web analytics instead of, or along with, Google Analytics. It can be enabled in the core config by setting the two required parameters `config.matomo_analytics_server` and `config.matomo_analytics_site_id`. 

It works analogue to the code for enabling Google Analytics and as such is pretty straightforward.
Latest commit 13048b1 Nov 6, 2018
Failed to load latest commit information.
bin Handle changes to ENGINE_PATH since Rails 5.1 Sep 27, 2017
certs Update my gem signing certificate Oct 29, 2018
config Added spring support for slightly faster development. Dec 6, 2014
core Add Matomo open web analytics (#3405) Nov 6, 2018
doc/guides Remove financials - pledgie has closed down May 3, 2018
dragonfly Closes GH-3376 Jul 16, 2018
exe Move refinerycms executable to exe/. Apr 9, 2015
images #3391 Switch to selenium with chrome headless Aug 24, 2018
lib Baby steps in removing authentication from refinery. (woohoo!) Jul 18, 2015
pages Use params[:visual_editor] to render insert action Sep 7, 2018
resources List all file types in `incorrect_format` locales :en and :fr Sep 20, 2018
spec Add no-sandbox config Aug 24, 2018
tasks authentication is no longer part of this repo Sep 19, 2015
templates/refinery Bump refinerycms to 4.0.0 Sep 27, 2017
testing #3391 Switch to selenium with chrome headless Aug 24, 2018
tmp/pids Add tmp/pids folder. Jun 12, 2012
.gitignore Remove exclude .txt files in gitignore Sep 20, 2018
.pullreview.yml Fix Malformed PullReview conf file Dec 8, 2014
.rspec Randomly order specs. Nov 25, 2013
.travis.yml Update travis config to support Chromedriver Aug 24, 2018
.yardopts authentication is no longer part of this repo Sep 19, 2015
Gemfile Losen mysql2 gem version Sep 3, 2018
Rakefile Update Rails 3.2 -> Rails 4.0 APIs. Sep 2, 2013 Changelog : Add current changes for 5.0.0 Aug 25, 2018 Allow use of webserver Mar 29, 2012 Now use https protocol for links to Nov 7, 2017 the Resolve Digital website now runs on HTTPS. Link directly to avoid… Mar 12, 2016 Update Jan 19, 2018
refinerycms.gemspec Now use https protocol for links to Nov 7, 2017

Refinery CMS™

An open source content management system for Rails 5.1+

More information at

Build Status Code Climate Coverage Status

You can chat with us using Gitter:

Gitter chat


  • Bundler
  • ImageMagick
    • ⚠️ Warning: ImageMagick currently has a serious security vulnerability, CVE-2016–3714. After installing, you must disable certain features in ImageMagick's policy configuration. Please see the following for details:
    • Mac OS X users should use homebrew's brew install imagemagick or the magick-installer.

How to

Getting Started

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

For Rails 5.1+ support, you can use version 4.0.x using this template:

rails new app_name -m

For Rails 4.2.x support, you can use version 3.0.x using this template:

rails new app_name -m

You can also install the edge version for the latest code 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.


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 CMS™ 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.