If you’re using Gatsby to run a blog and you’ve started adding some content to it, the next thing to think about is how to increase engagement among your visitors. A great way to do that is to allow them to ask questions and express their views on what you’ve written. This will make your blog seem much more lively to anyone visiting it.
There are many options out there for adding comment functionality, several of them specifically targeted at static sites. While this list is by no means exhaustive, it does serve as a good starting point to illustrate what’s available:
You can also roll your own comment system, as Tania Rascia wrote on the Gatsby blog.
In this guide, you’ll learn how to implement Disqus on your blog as it has a number of nice features.
- It is low maintenance, meaning moderating your comments and maintaining your forum less hassle.
- It provides official React support.
- It offers a generous free tier.
- It seems to be by far the most widely used service.
- It’s easier to comment: Disqus has a large existing user base and the onboarding experience for new users is fast. You can register with your Google, Facebook or Twitter account and users can more seamlessly share the comments they write through those channels.
- The Disqus UI has a distinct but unobtrusive look that many users will recognize and trust.
- All Disqus components are lazy-loaded, meaning they won’t negatively impact the load time of your posts.
Bear in mind, however, that choosing Disqus also incurs a tradeoff. Your site is no longer entirely static but depends on an external platform to deliver your comments through embedded
If these concerns outweigh the benefits of Disqus, you may want to look into some of the other options above. We welcome pull requests to expand this guide with setup instructions for other services.
Here are the steps for adding Disqus comments to your own blog:
- Sign-up to Disqus. During the process you’ll have to choose a shortname for your site. This is how Disqus will identify comments coming from your site. Copy that for later.
- Install the Disqus React package
- Add the shortname from step 1 as something like
.env.examplefiles so that people forking your repo will know that they need to supply this value to get comments to work. (You need to prefix the environment variable with
GATSBY_in order to make it available to client-side code.)
- In your blog post template (usually
src/templates/post.js) import the
Then define your Disqus configuration object
identifier must be a string or number that uniquely identifies the post. It could be the post’s slug, title or some ID. Finally, add
DiscussionEmbed to the JSX of your post template.
And you’re done. You should now see the Disqus comment form appear beneath your blog post looking like this. Happy blogging!
Edit this page on GitHub