Skip to content
A Gatsby theme for site SEO. Built with TypeScript.
TypeScript JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
package.json Inital Commit Sep 18, 2019
yarn.lock Add sitemap plugin Nov 5, 2019


A Gatsby theme for site SEO. Built with TypeScript.


yarn add gatsby-theme-seo


Name Optional Type Default
title No string None
description Yes string None
lang No string 'en'
image Yes Image None
meta Yes array None
keywords Yes string[] None
pathname Yes string None

Image Object

Name Optional Type Default
src No string None
height No string None
width No string None


In your sites gatsby-config:

module.exports = {
    plugins: [
            resolve: 'gatsby-theme-seo', 
            options: {
                title: 'My awesome website',
                author: 'Rich Haines',
                siteUrl: '',
                social: {
                    twitter: 'studio_hungry'
import React from 'react';
import {SEO} from 'gatsby-theme-seo';

const Index = () => (
        <SEO title="Test" description="My site is super amazing"/>
        <h1>This is a title</h1>

export default Index;

The description is optional so you can grab it (as well as other data like keywords and images) from a data source. This gives you the flexibility to allow your CMS to dictate this information instead of the hardcoded values from the themes options.

import React from 'react';
import {SEO} from 'gatsby-theme-seo';
import {graphql, useStaticQuery} from 'gatsby';

const Index = () => {
  const content = useStaticQuery(query);
  const metadata = content.allSanityMetadata.edges;
  return (
      {{node}) => (
        title="My Awesome Website"

export default Index;

export const query = graphql`
  query MainImageQuery {
    allSanityMetadata {
      edges {
        node {

Built With


  • Rich Haines - Hungry Bear Studio


This project is licensed under the MIT License

You can’t perform that action at this time.