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


The Top Web Design Features Small Business Owners Need to Succeed Online

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 May 5

Discover the secrets to designing a website that speaks to your small business's unique identity

As a website developer in Michigan, I’ve worked with many small business owners looking to redesign their websites to increase sales and connect with new and existing customers. As such, I’ve seen what works and what doesn’t work and cultivated a list of valuable tips that I give to all my clients.

As a small business owner in Michigan, your website is frequently the first impression that customers have of your company. It’s essential that your website is not only visually appealing an...

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...

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