How To Setup Email Newsletters For Gatsby Blogs With ConvertKit

31 May, 2020 (3 min read)

Having an email newsletter subscription flow setup for your blog is great because it helps you retain/engage your readers and drive repeated traffic to your site amongst other reasons.

Granted, there are a couple of tools available for doing this such as Mailchimp, Aweber, Hubspot, e.t.c. Gatsby even has a plugin for using mailchimp. However, for my blog, I decided to go with ConvertKit because:

  • There are a lot of good reviews about it.
  • The UI is really simple to use and navigate.
  • It has a free tier, so you can experiment before commiting.
  • The one and only Monica Lent recommended it.

This article assumes that you have some experience using Gatsby or React.

To get started with ConvertKit,

  1. Sign Up on ConvertKit.
  2. Click on 'Landing Pages and forms' > 'Create New'.
  3. Click on 'Form' and select the 'inline' display format option.
  4. Choose any template you fancy. I chose the Mills template.
  5. Click on 'Embed'

    convetkit embed
  6. Click on 'Html' and take note of the form’s action url and the names of input tags present (scroll, look closely and you’ll find them). We’ll be using them later.

    converkit html

Integrating With Gatsby

Due to the way Gatsby is written, you can’t directly embed the 'script tag' or the 'HTML' options into your code. The easiest way is to create a custom subscription form as a component.

//In src/components/sub-form.component.js
import React, { useState } from 'react';
import Button from "../button/button.component";

const SubscriptionForm = () => {
    const [status, setStatus] = useState(null);
    const [email, setEmail] = useState('');

    //FORM_URL should be the same as the form action url pointed out above
    const FORM_URL = ``;

    const handleSubmit = async (e) => {
        const data = new FormData(;
        try {
            const response = await fetch(
                    method: 'post',
                    body: data,
                    headers: {
                        accept: 'application/json',
            const json = await response.json();
            if (json.status === 'success') {
        } catch (err) {

    const handleInputChange = event => {
        const {value} =;

    return (
        <div className="sub">
            <h2>Join My Newsletter</h2>
               If you've found any of my articles useful, subscribe to receive more quality articles straight to your inbox.

            {status === 'SUCCESS' && <p>Please go confirm your subscription!</p>}
            {status === 'ERROR' && <p>Oops, Something went wrong! try again.</p>}

            <form className="sub__form"
                    aria-label="Your email"
                   //The name attribute should be the same as on you selected form.
                    placeholder="Your email address"

                <Button type="submit">


            <p className="sub__tag">I won't send you spam and you can unsubscribe at any time</p>


export default SubscriptionForm

You can style the subscription form component however you want, then import and use it in your blog pages template file or wherever else you wish.

To Test: Enter an email address into your form and click on the subscribe button. If you receive a success message and confirmation email to that email address then you’re good to go.

P.S: This should be done on a live site not on localhost.

You can also make changes to the contents of the confirmation email, tweak other settings for your form, and create an email template for your broadcasts.

I’m hoping you’ll figure your way around. If you have any further questions, ask away in the comment section or hit me up on twitter

PS: If you're building a blog, you may also want to add social media share buttons directly to your blog pages.

Now go on and build something great!

Join My Newsletter

If you've found any of my articles useful, subscribe to be notified of more quality articles as soon as they're published.

I won't send you spam and you can unsubscribe at any time

💖 & Always, From Linda Ikechukwu.

© 2021. Made with Gatsby