Add comments to your blog with utterances

A lightweight comments widget built on GitHub issues. Use GitHub issues for blog comments, wiki pages and more!

• Open source . 🙌
• No tracking, no ads, always free. 📡🚫
• No lock-in. All data stored in GitHub issues. 🔓
• Styled with Primer , the css toolkit that powers GitHub. 💅
• Dark theme. 🌘
• Lightweight. Vanilla TypeScript. No font downloads, JavaScript frameworks or polyfills for evergreen browsers. 🐦🌲

After I gave up on the comments feature (no one reads my two-month-old blog anyway), I stumbled upon utterances and it blew my mind with its simplicity. It took me 10 minutes to add it to this blog, build time included.

✎ This is how the comment section will appear, from my homepage.

So, how does it work?

First of all, it uses GitHub issues to track comments, based on the post title: the first person to comment on a blog post will trigger the creation of a related issue and future comments on the same post will end up in that issue.

Smart, right? 🔮

The only requirements are that the repository connected to the app needs to be public and have the utterances app installed on it.

Users will comment using their GitHub account, which is perfect for a tech/programming blog.

Oh, and it comes with 8 themes that will play well with most of the colour palette of the blogs out there!

How to install it ?

Their page is pretty straightforward: just follow the configuration steps (repository name, optional label for the issues, chosen theme and even issue title format!) and you’re left with a script tag to add to your blog template:

<script src="https://utteranc.es/client.js"
        repo="dervicblog/utterances"
        issue-term="pathname"
        label="💬"
        theme="boxy-light"
        crossorigin="anonymous"
        async
    ></script>

Note that the issue label supports emojis! 🎉

After that, just remember to install the utterances app on the same repository you provided in the repo attribute and you’re done!

Shameless plug

If you found this post useful and you liked it, why don’t you leave a comment below? I’d like to know what you think about this.

🐘 Congratulations, you’re now able the utterances of your website.