Skip to main content
Official Plugin
View plugin on GitHub
See starters using this


The Gatsby blog theme

A Gatsby theme for creating a blog.


Use the blog theme starter

This will generate a new site that pre-configures use of the blog theme.

gatsby new my-themed-blog

Manually add to your site

npm install --save gatsby-theme-blog


Theme options

Key Default value Description
basePath / Root url for all blog posts
contentPath /content/posts Location of blog posts
assetPath /content/assets Location of assets
mdx true Configure gatsby-plugin-mdx (if your website already is using the plugin pass false to turn this off)

Example usage

// gatsby-config.js
module.exports = {
  plugins: [
      resolve: `gatsby-theme-blog`,
      options: {
        // basePath defaults to `/`
        basePath: `/blog`,

Additional configuration

In addition to the theme options, there are a handful of items you can customize via the siteMetadata object in your site’s gatsby-config.js

// gatsby-config.js
module.exports = {
  siteMetadata: {
    // Used for the site title and SEO
    title: `My Blog Title`,
    // Used to provide alt text for your avatar
    author: `My Name`,
    // Used for SEO
    description: `My site description...`,
    // Used for social links in the root footer
    social: [
        name: `twitter`,
        url: ``,
        name: `github`,
        url: ``,