A Gridsome blog engine like no other

Meet the Gridsome blog engine that integrates with your website using a straightforward API. Smooth, simple, and tasty content integration — that’s Butter.

Posted on November 28, 2023

Intuitive admin interface

So easy to use. So easy to customize. You’re going to love the blog you build with ButterCMS.

Handy integration with Gridsome

Our Gridsome blog engine has a simple content API and drop-in SDKs that make the magic happen in minutes, not hours.

A truly zero-maintenance solution

With ButterCMS, you’ll never worry about security upgrades, hosting, or performance again.

You've got better things to do than build another blog

Drop our Gridsome blog engine into your app, and get back to more interesting problems.

ButterCMS is an API-based blog engine that integrates seamlessly with new and existing Gridsome apps. It's great for SEO, and provides a clean and modern user interface that your marketing team will love. You can deploy ButterCMS in minutes using our Gridsome API client. 

That leaves plenty of time for you and your marketing team to do what you do best: create killer apps with killer content. 

Play video

See how Butter’s API enables you to launch a flexible blog with amazing SEO using your existing tech stack.

G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award G2 crowd review award

Best blog engine on the market

headshot of Hampton Catl

After shopping the market, it was clear that ButterCMS was the perfect choice. It allows our developers to build powerful components and makes it easy for our marketing team to drive a better customer experience. Hampton Catlin Creator of Sass and Haml

Deploy our Gridsome Starter in 30 seconds

Or follow the below commands to clone a copy of the repo from github, install dependencies, set your free Butter token, and run your local server on localhost:8080/.

$ git clone https://github.com/ButterCMS/gridsome-starter-buttercms.git
$ cd gridsome-starter-buttercms
$ npm install
$ echo 'GRIDSOME_APP_BUTTER_CMS_API_KEY=your_free_api_token_here' >> .env
$ npm run start

Built to make content marketing easy

ButterCMS is the best Gridsome blog engine for a simple reason: Gridsome developers can build solutions that marketing people love. Our API allows your content gurus to quickly spin up high-converting blog templates, sidebars, related content features, and more, all using simple drag-and-drop functionality.

  • Use main domain (improves SEO)
  • Friendly admin interface
  • Upload images, video, and other media
  • Edit URL slugs and meta tags
  • Tags and categories
  • Author profiles
  • RSS/Atom feeds
  • Search
  • Webhooks
  • And more...

The simplest Gridsome blog engine you'll find

Our simple setup saves you time and money. Take us for a spin to see for yourself!

headshot of LUKE GARDNER

It's the epitome of plug-and-play simplicity for content creators. It does exactly what I need it to. LUKE GARDNER, CONTENT SPECIALIST, PRINTAVO

Fast integration with any Gridsome app

Our mission was to make it easy to integrate Butter with your existing Gridsome app in minutes. It’s so simple! To demonstrate, here’s a mini tutorial to give you a feel for the process of adding Butter to your Gridsome app.

Of course, you can also use our Pages and Collections to do advanced content modeling. For a full integration guide, check out our Official Guide for the ButterCMS Gridsome API client.

Play video

See how easily you can integrate the ButterCMS Pages API with your Gridsome app.

Seamless Gridsome components

Empower your marketing team to create a customized blog engine that aligns perfectly with your Gridsome components. 

Components are the essential building blocks of any Gridsome app, and ButterCMS handles them with ease. 

Our drag and drop interface makes it simple to structure your content to match existing Gridsome components and to create new reusable components whenever you need them.

The best Gridsome blog engine for SEO

ButterCMS gives you absolute control over on-page SEO ranking factors. Key SEO variables are built into our default post template, giving your marketing team direct access to configure all of these settings, and more.

  • Page title
  • Post tags and categories
  • META description
  • URL slug
  • Featured image / Open Graph image
  • Image ALT tags
  • Link anchor text

ButterCMS saves you development time

Most customers get our Gridsome blog engine up and running in less than an hour. Try it yourself!

headshot of DILLON BURNS

Simple as can be, with powerful features and great customer support. DILLON BURNS, FRONT END DEVELOPER, KEYME

How to integrate ButterCMS into your Gridsome application

Integrating the Butter blog engine into your Gridsome app is dead simple. Here's a mini tutorial to get a feel for setting up your blog home and blog post pages. 

For a full integration guide, check out our Official Gridsome Guide

First you'll need to configure a bit of code in your Gridsome project so that it can pull in your Blog posts from ButterCMS. The key bit of code is the config code that connects your project to gridsome via the npm "gridsome-source-buttercms" module. In your gridsome project, open the gridsome.config.js file.

Replace the AuthToken with your ButterCMS token. Page Posts is baked into ButterCMS, so you don’t have to explicitly declare it in your gridsome.config.js file.

module.exports = {
  siteName: 'Gridsome',
  plugins: [{
    use: "gridsome-source-buttercms",
    options: {
      authToken: 'a985f3f782f2005...<your AuthToken>',
      collections: [''],
      pages: '',
      pageTypes: ''
    }}
  ]
}

Next in your components folder, create PostCard.vue with the following code:

<template>
  <div class="post-card__content-box">
    <div class="post-card__header">
      <g-image
        alt="Cover image"
        v-if="post.featured_image"
        class="post-card__image"
        :src="post.featured_image"
      />
    </div>
    <div class="post-card__content">
      <h2 class="post-card__title" v-html="post.title" />
      <p class="post-card__description" v-html="post.summary" />
      <PostMeta class="post-card__meta" :post="post" />
    </div>
  </div>
</template>

<script>
import PostMeta from "~/components/PostMeta";

export default {
  components: {
    PostMeta
  },
  props: ["post"]
};
</script>

<style lang="scss">
.post-card {
  margin-bottom: var(--space);
  position: relative;

  &__content-box {
    display: flex;
    flex-direction: row;
    align-items: flex-start;
  }

  &__header {
    margin-left: calc(var(--space) * -1);
    margin-right: calc(var(--space) * -1);
    margin-bottom: calc(var(--space) / 2);
    margin-top: calc(var(--space) * -1);
    overflow: hidden;
    border-radius: var(--radius) var(--radius) 0 0;
    flex-basis: 25%;
    &:empty {
      display: none;
    }
  }
  &__content {
    flex-basis: 75%;
  }
  &__image {
    border: 2px solid gray;
    width: 80%;
    margin-left: 20px;
    margin-right: auto;
    box-shadow: 1px 10px 30px 0 rgba(0, 0, 0, 0.1);
    border-radius: 8px;
    border: 1px solid #ddd;
    border-radius: 4px;
    padding: 5px;
    align-content: center;
  }
  &__title {
    margin-top: 0;
    margin-bottom: 0;
  }

  &__description {
    margin-top: 0;
    display: block;
    margin-block-start: 0em;
    margin-block-end: 0em;
    margin-inline-start: 0px;
    margin-inline-end: 0px;
  }

  &:hover {
    transform: translateY(-5px);
    box-shadow: 1px 10px 30px 0 rgba(0, 0, 0, 0.1);
  }

  &__tags {
    z-index: 1;
    position: relative;
  }

  &__link {
    position: absolute;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
    opacity: 0;
    overflow: hidden;
    text-indent: -9999px;
    z-index: 0;
  }
}
</style>

Next, build another component PostMeta.vue in components with this code:

<template>
  <div class="post-meta">Posted {{ post.published }}.</div>
</template>

<script>
export default {
  props: ["post"]
};
</script>

<style>
.post-meta {
  font-size: 0.8em;
  opacity: 0.8;
}
</style>

You’ll use your PostCard component in Index.vuefile in the Pages folder. Replace everything inside the component with this code:

<template>
  <Layout>
    <!-- List posts -->
    <div class="posts">
      <PostCard
        v-for="edge in $page.posts.edges"
        :key="edge.node.id"
        :post="edge.node"
      />
    </div>
  </Layout>
</template>

Then add your GraphQL query:

<page-query>
query {
  posts: allButterPosts(order: ASC) {
    edges {
      node {
        id
        title
        url
        published  (format: "MMMM Do, YYYY")
        slug
        summary
        body
        featured_image
        tags {
          name
          slug
        }
      }
    }
  }
}
</page-query>

And finally, update your <script> and <style> tags:

<script>
import PostCard from "~/components/PostCard.vue";

export default {
  components: {
    PostCard
  },
  metaInfo: {
    title: "Hello, ButterCMS!"
  }
};
</script>

<style>
</style>

That's it! The blog posts created in your Butter dashboard will immediately show up in your app.

Get Started for Free

Try Butter free for 14 days

See for yourself what makes Butter the best Gridsome blog engine out there. Click the button below to sign up for your free 14-day trial.