Comments
Hugo ships with support for Disqus, a third-party service that provides comment and community capabilities to websites via JavaScript.
Your theme may already support Disqus, but if not, it is easy to add to your templates via Hugo’s built-in Disqus partial.
Add Disqus
Hugo comes with all the code you need to load Disqus into your templates. Before adding Disqus to your site, you’ll need to set up an account.
Configure Disqus
Disqus comments require you set a single value in your site’s configuration file like so:
services:
disqus:
shortname: your-disqus-shortname
[services]
[services.disqus]
shortname = 'your-disqus-shortname'
{
"services": {
"disqus": {
"shortname": "your-disqus-shortname"
}
}
}
For many websites, this is enough configuration. However, you also have the option to set the following in the front matter of a single content file:
disqus_identifier
disqus_title
disqus_url
Render Hugo’s built-in Disqus partial template
Disqus has its own internal template available, to render it add the following code where you want comments to appear:
{{ template "_internal/disqus.html" . }}
Alternatives
These are some alternatives to Disqus:
- Cactus Comments (Open Source, Matrix appservice, Docker install)
- Commento (Open Source, available as a service, local install, or docker image)
- Giscus (Open source, comments system powered by GitHub Discussions)
- Graph Comment
- Hyvor Talk (Available as a service)
- IntenseDebate
- Isso (Self-hosted, Python) (tutorial)
- Muut
- Remark42 (Open source, Golang, Easy to run docker)
- ReplyBox
- Staticman
- Talkyard (Open source, & serverless hosting)
- Utterances (Open source, GitHub comments widget built on GitHub issues)