Adding Comments to your Blog

This walkthrough goes over different ways that you can add comments to your blog. These commenting options are mostly free & open source and, at most, are on a pay what you want subscription model.

The walkthrough will be updated with more details and methods as they come along. Feel free to leave questions, feedback, and suggestions about other ways to implement comments into - we’d love to hear them!


Commento is an awesome open source commenting platform. It is a subscription based on a pay what you want model. After setting up your account, adding Commento to your blog is just a matter of adding some code to the Custom JavaScript of your blog settings:

// src:

var topP = document.createElement("p");
topP.innerHTML = '<div id="commento"></div>';
var cont = document.getElementById("wrapper");
cont = document.getElementById("post-body");

if (cont !== null) {

Commento allows for people to comment anonymously or with accounts. Big thanks to @Aris for bringing Commento up in a previous form post and @yungleary for helping us work our way to a stable implementation of the Commento embed:


Utterances is an open source comment widget that is powered by Github. You need a Github account in order to get started. All you need to do is the following:

  1. Create a repo for your comments.
  2. Install Utterances Github app (make the app apply to the commenting repo or across all your repos)
  3. Add the following code to the Custom JavaScript of your blog settings, changing the :“user/repo” to fit your Github account and comment repo. Learn more about the other attributes here:
var comments = document.createElement("script");
comments.src = '';
comments.async = true;
comments.crossOrigin = 'anonymous';
comments.setAttribute('repo', 'user/repo');
comments.setAttribute('issue-term', 'pathname');
comments.setAttribute('label', '');
comments.setAttribute('theme', 'github-light');

NOTE - comments can only be created by people that have a Github account. They will be prompted to log in and, once authenticated, they can comment on any of your blog posts. This is great for development focused blogs where the audience most likely has a Github account. Here is an example of Utterances in action. Big thanks to Robert Xu for showing us this!


Hypothesis is an open source annotation tool that allows for sentence-level comments and highlights across the web. You can set up Hypothesis on your blog to resemble Medium-like highlights and in-line comments on your blog. All you need is a Hypothesis account (it’s free and you get to annotate across the entire web as an extra benefit). Once you’re set up, add the following code to the Custom JavaScript of your blog settings:

// src:

window.hypothesisConfig = function () {
  return {
    "openSidebar": false, 
    "theme": "clean",
    branding: {
      appBackgroundColor: 'white',
      ctaBackgroundColor: 'rgba(3, 11, 16, 1)',
      ctaTextColor: '#eee',
      selectionFontFamily: 'helvetica, arial, sans serif'

This will allow people to highlight and comment on parts of your blog posts as Hypothesis annotations. The commented sentences will turn up as highlighted, allowing for people to see the specific comments.

NOTE - comments can only be done by people with Hypothesis accounts. Again, it’s free and allows you to annotate across the web, not just the one post.

Check out my blog to see Hypothesis in action as a commenting system for a blog. Past users have implemented it too, including @mikka, so thinks to him for having tried it out:


@cjeller1592 Another open source commenting system is Talkyard. It also has a hosted version, which has a $1.90/mo plan. For that you can use it on as many blogs or domains as you like.

1 Like

The problem is all of those products are targeted towards western markets, including I think going forward price localization should be considered as part of the federated business model. Because let me tell you what it feels like to pay for each of those services as an university student from a developing country:

  • Pro subscription normally costs 60$ per year(Less with student discount), which equals to about 400 units in my local currency,
  • Commento also costs 60$ per year at minmum, which again equals to about 400 units
  • [Put some other service with similar pricing here]

Now let me ask you, would you pay 800$ for just two of those services each year? Because unit-wise our income amounts are similar. But due to inflation and other economic circumstances the expense ratio is enormous. (Yes, I could also setup WriteFreely on a cheap AWS but that defeats the whole purpose and also doesn’t really solve the issue. What about those who are not power-users?)

So what does a poor fella like me do? He naturally goes and uses services like Disqus which steals and sells the users’ data without their consent. And their monoculture keeps getting stronger because they are able to attract many customers like me. has a lovely DRM-free business model. But guess what? Everytime I wanted to buy a game from them I have used an IP proxy from Russia to deceive their system and get saner prices in return. Steam doesn’t have that issue, Steam localizes majority of their product prices. But Steam also has DRM and the final say on the matter if you really own a game or not. And that’s why it keeps winning.

I know that there ain’t no such thing as a free lunch. But there could be one such as fair lunch. If privacy-friendly, decentralized services to be gained momentum, they are going to need global support. Privacy shouldn’t be a luxury or only a thing that western people could afford.

So please @matt, @cjeller1592 when you keep working on your next project such as the, please keep the users like me in mind. I really love your work, I really want to support it but I also ask for a fair chance.

Going forward, maybe this should be one of the main topics. Money is not everything but it is also important. So we should ask ourselves how can we find the middle ground where it doesn’t put the strain on the service provider or the user in particular.

The current providing a basic service while allowing to pay for extra services model is unfortunately not fair either. Because while one can use the basic service because they wish to do so, the other has to use it because they can’t afford any better.


The tough part of is having a means of being aware of comments on your website. I’ve been hoping they’d support webmention or have some additional UI for website owners.

I am aware that Jon Udell has built some separate UI that may help out people trying this as a commenting system. Here’s a URL to it with an illustrative example:*&max=100


Yeah that’s a major catch of using Hypothesis, but seeing Jon’s tool gives me hope. Thanks for linking to that @chrisaldrich! I even think Hypothesis’ UI for searching annotations on a domain could be helpful (example). I’ve seen people who use Hypothesis on add that search link as a pinned post for people to look through comments on their blog. I can definitely see a custom tool that pulls together recent Hypothesis comments and puts it into a post too.

Totally agree with you there @agyild. That’s why we wanted to make sure that there are other commenting solutions on here that are completely free to use, like Utterances and Hypothesis, and want to continue searching for equally free, compatible, and privacy-focused services. If anyone finds anything please let us know.

And we’ll definitely keep your ideas in mind when developing and want the conversation to continue about accessible, privacy-first services too. Please feel free to put your input in our dedicated topic on

1 Like

I’ve seen a few people in the wild using as a blog commenting system.[1][2] Since they don’t yet have separate support for Webmention or require a bit of programming to get notifications, I thought I’d highlight this particular service/implementation as it has a simple, but relatively elegant user interface for creating feeds to provide notifications for just such a use case.

One could easily wire up the output from this through a service like IFTTT, Zapier, Integromat, etc. to push the notifications to email, or other modalities as desired.

It doesn’t give anything over and above what a addict with some programming skills could already produce, but for those who are code averse, or just too busy with building other pieces of the Domain of One’s Own this could allow some simpler outputs.

If you are a tinkerer, there is a GitHub repo for the project.

(Originally posted at


@chrisaldrich Thanks, I think this can be a very useful tool. I already see some ways I can use it to follow annotations on some scientific papers and content of interest. And it looks like it’s very general and can be used for annotations on all kinds of online content. And we’re given a lot of options for searching. Very nice tool, Chris!

Hello! I’m having some difficulty embedding I want to embed it in so that the arrow for the sidebar (which shows up when I activate the hypothesis extension) automatically shows up for viewers, so that the option to comment/annotate is clearer. I’ve added it to my own personal website (arrow on the right hand side) just using the basic hypothesis script embed, not sure how to recreate it on

As I mentioned in a previous thread what you are proposing it does make sense and most important is is the right way to go. For small companies it is not easy to implement this in practice though, but the need to start thinking for a way of overcoming the technicalities of this approach the soonest possible. I can’t recall a small company implementing such system, but if someone has a good example to follow I’d be more than happy to contact them in order to implement the same approach for providing hosting for Write Freely.