Gatsby.js CMS

Powerful CMS. Zero headache.

Drop our API-based CMS into your Gatsby.js app in minutes.

ButterCMS provides a CMS and content API for Gatsby.js apps. Use ButterCMS with Gatsby.js to enable dynamic content in your apps for page content, blogs, and more.

Above is quick video of integrating Butter's Pages API into an application.

“Best CMS on the market”

Butter's API slides right into our apps and lets us avoid having yet another WordPress site. Daniel, Founder Of Collective Idea

Marketers love Butter

  • SEO Landing Pages
  • Customer Case Studies
  • Company News & Updates
  • Events + Webinar Pages
  • Education Center
  • Location Pages
  • and more...

Butter saves you development time

Save thousands of dollars worth of development time with our easy setup.

Integrating Butter into our application took less than an hour and most of that time was spent on design work. Luke Brean, Legally

Everything you need

  • Custom Page Types
  • Customer Case Studies
  • Custom Content Modeling
  • CDN for assets
  • Testing environment
  • Location Pages
  • Webhooks
Beautiful admin interface

Easy to use. Easy to customize.

Integrates with Gatsby.js

Our CMS has a simple content API and drop-in Gatsby.js source plugin.

Butter requires zero maintenance

Never worry about security upgrades, hosting, or performance.

Setup in minutes

Integrating Butter into your Gatsby.js app is dead simple. Here's a mini tutorial to get a feel for adding marketing pages to your app. You can also use our Collections to do advanced content modeling. For full a integration guide check out our Official Guide

Above is quick video of integrating Butter's Pages API into an application.

With your homepage defined, the ButterCMS Pages API will return it in JSON format like this:

"data": {
    "slug": "homepage",
    "fields": {
      "seo_title": "Anvils and Dynamite | Acme Co",
      "headline": "Acme Co provides supplies to your favorite cartoon heroes.",
      "hero_image": "",
      "call_to_action": "Buy Now",
      "customer_logos": [
          "logo_image": ""
          "logo_image": ""

Now lets create the home page src/pages/index.js

import React from 'react'
import { graphql, Link } from 'gatsby'
import Layout from '../components/layout'
import SEO from '../components/seo'

const IndexPage = ({ data }) => {
  const home = data.home.edges[0].node

  return (
        <img src={home.hero_image} >

      <h1>Our Customers</h1>
        {{ logo_image }) => (

//GraphQl query to fetch homepage data
export const query = graphql`
    home: allButterPage(filter: { slug: { eq: "homepage" } }) {
      edges {
        node {
          customer_logos {

export default IndexPage

That's it! Now run gatsby develop in your terminal and open localhost:8000/home to see the home page populated with the content you created on butter.

Configure the source plugin

Here you'll specify the config that will be needed to pull down data from butter. Make sure to add your api_token from your dashboard, in this guide we will add CMS capability to a Gatsby for blogging, marketing pages, and more. Below is an example gatsby-config.js file that you'll want to configure for your app. We dive into more detail on the config file in the official guide.

// Example gatsby-config.js file
module.exports = {
      resolve: `gatsby-source-buttercms`,
      options: {
        authToken: ``,
        // Optional. Returns values for the supplied content field keys.
        contentFields: {
          keys: [`faq_items`, `faq_headline`],
          // Optional. Set to 1 to enable test mode for viewing draft content.
          test: 0,
        // Optional. Array of page slugs.
        pages: [`homepage`],
        // Optional. Array of page types.
        pageTypes: [`customer_case_study`],

That's it! If you browse to your homepage you'll see your homepage populated with the content you created in Butter.

Try ButterCMS Free

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.

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.

Do you host my templates?

Unlike CMS's you might be used to, we don't control or host any of your templates. The design of your app (HTML + CSS) lives in your application along side the rest of your app. Your application calls our Content API and we return your content in JSON format. You can then render this content in any way you'd like.

Can I import my content?

Yep. To import existing content from another platform, simply send us an email.

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.

Can I self host Butter?

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.

More questions? We're happy to help.
Chat With Us

Try Butter free for 30-days