
Ruby Blog Engine
You've got better things to do than build another blog
Add Butter to your Ruby app and get back to more interesting problems
"Best CMS on the market"

ButterCMS is an API-based Ruby blog engine that integrates with Ruby apps in minutes. Use ButterCMS with Rails, Sinatra, and other Ruby frameworks to build CMS-powered apps quickly. ButterCMS works great for blogs, dynamic pages, and more.
Above is quick video of integrating Butter's blog engine into an application.

Butter's Blog API slides right into our apps and helps avoid having yet another WordPress site.
Daniel, Founder of Collective IdeaAll your requirements, solved
Use main domain (for SEO)
Friendly admin interface
Upload images and media
Edit slugs and meta tags
Tag and categorize posts
RSS/Atom Feeds
Search
Webhooks
Powerful admin interface

Integrates with Ruby
Our blog engine has a simple API and drop-in Ruby SDK.
Save development time
Save thousands of dollars worth of development time with our easy setup.
Gives you great SEO
Host your blog on your main domain and customize slugs and meta tags.
Try ButterCMS in your Ruby appSetup in minutes
Integrating Butter into your Ruby app is dead simple. Here's a mini tutorial to get a feel for of setting up your blog home and blog post pages. For full an integration guide check out our Official Ruby Guide
To display posts we create a simple /blog
route in our app and fetch blog posts from the Butter API. See our API reference for additional options such as filtering by category or author. The response also includes some metadata we'll use for pagination.
require 'rubygems'
require 'bundler'
require 'buttercms-ruby'
ButterCMS::api_token = 'your_token'
class App < Sinatra::Base
get '/blog' do
params[:page] ||= 1
@posts = ButterCMS::Post.all(:page => params[:page], :page_size => 10)
@next_page = @posts.meta.next_page
@prev_page = @posts.meta.previous_page
erb :index
end
end
Next we'll create a simple view named blog.html.erb
that displays our posts and pagination links:
<h2>Posts</h2>
<!-- List of posts -->
<% @posts.each do |post| %>
<a href="<%= url("/blog/#{post.slug}") %>"><%= post.title %></a>
<br>
<% end %>
<!-- Pagination links -->
<div>
<% if @previous_page %>
<a href="<%= url("/blog?page=#{@prev_page}") %>">Prev</a>
<% end %>
<% if @next_page %>
<a href="<%= url("/blog?page=#{@next_page}") %>">Next</a>
<% end %>
</div>
We'll also create an additional route for displaying individual posts:
class App < Sinatra::Base
...
get '/blog/:slug' do
@post = ButterCMS::Post.find(params[:slug])
erb :post
end
end
The view for displaying a full post includes information such as author, publish date, and categories. See a full list of available post properties in our API reference. We use the content_for
Sinatra helper for setting the HTML title and meta description in the <head>
tag of the page.
<% content_for(:title) { @post.seo_title } %>
<% content_for(:meta_description) { @post.meta_description } %>
<!-- Post title -->
<h2><%= @post.title %></h2>
<!-- Post author -->
<a href="<%= url("/author/#{@post.author.slug}") %>"><%= "#{@post.author.first_name} #{@post.author.last_name}" %></a>
<!-- Post categories -->
<% @post.categories.each do |category| %>
<a href="<%= url("/category/#{category.slug}") %>"><%= category.name %></a>
<% end %>
<!-- Publish date -->
<%= @post.published %>
<!-- Post body -->
<%= @post.body %>
About ButterCMS
ButterCMS is an API-based, or "headless", CMS. We're a hosted service and we maintain all of the infrastructure. For more information on how we compare to a traditional CMS check out API-based CMS vs Traditional CMS.
How do you compare to Wordpress?
In short, we offer all the same easy-to-use editing capabilities of Wordpress but are significantly easier for developers to setup and maintain. This means you spend less time working on your CMS and more time focusing on things important to your business.
Learn more about how we're a wordpress alternative.
What's my blog going to look like?
Unlike CMS's you might be used to, we don't control or host any of your templates. The design of your blog (HTML + CSS) lives in your application along side the rest of your app. Your application calls our Blog Engine API to get the raw blog post content and then injects it into your own templates during rendering. This has many benefits including blog your instantly matching the rest of your site branding giving it a unique feel; not the cookie-cutter blog themes you'll experience with other CMS's.
Can I import my existing blog content?
Yep. To import content from another platform, simply send us an email.
What kind of database can I use?
No database required! We're a SaaS CMS or CaaS. You simply call our Content API from your app. We host and maintain all of the CMS infrastructure.
Can I host this?
No, we're a SaaS CMS or CaaS. You simply call our Content API from your app. We host and maintain all of the CMS infrastructure.
I have other questions
We're happy to help.
Chat with usAbout Ruby
Ruby is a dynamic, open source programming language with a focus on simplicity and productivity. It has an elegant syntax that is natural to read and easy to write.