How to Add Structured Data to Blog Posts in Gatsby

Adding structured data to your blog posts with react-helmet is a simple way to display previews of your content

Profile Pic of Snappy Web Design

Jun 7 · 4 min read

How to Add Structured Data to Blog Posts in Gatsby

Structured data tells search engines the exact content of a webpage, and is complementary to meta tags.

Structured data is important for SEO because it makes it easier for Google to understand what your blog post and website are about. Google will use your structured data to show a rich search result, which are always displayed at the top of results, putting your website in the best position for increased click through rates.

Using React Helmet

React Helmet is the best way to add structured data with Gatsby. Start by installing it via npm

npm install gatsby-plugin-react-helmet react-helmet

and add it to your plugin array inside of gatsby-config.js

plugins: [gatsby-plugin-react-helmet]

We'll create a separate component called StructuredData.js where we initialize react-helmet. We'll pass in an article prop so that we show previews for blog posts, but not for other pages on our sites (which would cause errors).


import React from "react" import { Helmet } from "react-helmet" const StructuredData = ({ article }) => { return ( <Helmet title="Structured Data Example"> {(article ? true : null) && ( <script type="application/ld+json"> {JSON.stringify({ "@context": "", "@type": "BlogPosting", mainEntityOfPage: { "@type": "WebPage", "@id": `` }, headline: `How to Add Structured Data to Blog Posts in Gatsby`, description: `Adding structured data to your blog posts with react-helmet is a simple way to display previews of your content`, image: ``, author: { "@type": "Organization", name: `Snappy Web Design` }, publisher: { "@type": "Organization", name: `Snappy Web Design`, logo: { "@type": "ImageObject", url: "" } }, datePublished: `2021-06-07`, dateModified: `2021-06-07` })} </script> )} </Helmet> ) } export default StructuredData

Then we import the component inside of BlogPost.js to add structured data to our blog posts:


import React from "react" import StructuredData from "../StructuredData" const BlogPost = () => ( <> <StructuredData article={true} /> <h1>This is my blog post</h1> <p>Welcome to my blog post with structured data</p> <p>To the top of the google search results we come!</p> </> ) export default BlogPost

Wrapup - You're done!

Use the Rich Results Test provided by Google to make sure you've set everything up correctly and check your data is coming through as expected.

If everything looks good - you're done! Adding structured data to your blog posts in gatbsy with react-helmet is as easy as 1-2-3! You can check out the final code here

Make sure to press the follow button below to be notified when new posts go live! 🔔

Hire me

Most popular posts


How to Code a Dark Theme with Material UI


Gatsby Code Splitting


Michigan Website Design

For Developers


How to make a Font Size Slider in React with Material UI


How to Add Breadcrumbs to Google Search in Gatsby


How to Code a Social Share Button with Material UI

For Business Owners


What the heck is Gatsby js and why use it


10 Landing Page Designs to Inspire Your Small Business


About Google Page Speed Scores and Why They Matter

More from Snappy Web Design

Subscribe to the Snappy Web Design Blog to get notified when a new post goes live. We'll never share your e-mail address or use it for any reason other than to share new posts.

Published September 1

Snappy Web Design is the one-stop-shop for web design.

Michigan's Newest Web Design Company

You search Google for “Michigan web design” and find my site. I’m Joe, and I’m the head developer at Snappy Web Design. I’m the new guy on the block, and an expert in providing full-service web design for small business owners in MI.

I’m different from typical web design agencies because I aim to be your partner for all things related to your onli...

Published August 6

You’ve heard of WordPress, Squarespace, and Wix...but what the heck is Gatsby.js?

You’re hiring a freelancer or agency to build your company's website and considering your options - WordPress, Squarespace, Wix - and then, someone mentions Gatsby.js. You learn that it’s used by many of the largest companies across the globe - but you’ve never heard of it, and don’t know what to think. This is the position that 95% of our new clients find themselves in and it’s understandable. Technology evolves fast and it can be hard to keep up. However, if you’re hiring an agency to build...

Copyright © 2022. Snappy Web Design. All rights reserved.