2019-10-21 04:22:28 -04:00
---
title: Comments
description: Hugo ships with an internal Disqus template, but this isn't the only commenting system that will work with your new Hugo website.
keywords: [sections,content,organization]
2023-07-29 05:15:54 -04:00
categories: [project organization]
2019-10-21 04:22:28 -04:00
menu:
docs:
2022-11-17 10:14:29 -05:00
parent: content-management
weight: 220
2019-10-21 04:22:28 -04:00
toc: true
2022-11-17 10:14:29 -05:00
weight: 220
aliases: [/extras/comments/]
2019-10-21 04:22:28 -04:00
---
Hugo ships with support for [Disqus ](https://disqus.com/ ), 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][disquspartial].
## 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][disqussetup].
### Configure Disqus
Disqus comments require you set a single value in your [site's configuration file][configuration] like so:
2023-05-22 10:43:12 -04:00
{{< code-toggle copy = false > }}
2022-03-08 13:37:17 -05:00
disqusShortname = "yourDisqusShortname"
2019-10-21 04:22:28 -04:00
{{< / code-toggle > }}
2022-12-20 05:04:41 -05:00
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:
2019-10-21 04:22:28 -04:00
* `disqus_identifier`
* `disqus_title`
* `disqus_url`
2023-07-29 05:15:54 -04:00
### Render Hugo's built-in Disqus partial template
2019-10-21 04:22:28 -04:00
2023-07-29 05:15:54 -04:00
Disqus has its own [internal template ](/templates/internal/#disqus ) available, to render it add the following code where you want comments to appear:
2019-10-21 04:22:28 -04:00
2022-11-17 10:14:29 -05:00
```go-html-template
2019-10-21 04:22:28 -04:00
{{ template "_internal/disqus.html" . }}
```
2021-10-31 08:51:51 -04:00
## Alternatives
2019-10-21 04:22:28 -04:00
2021-10-31 08:51:51 -04:00
These are some alternatives to Disqus:
2019-10-21 04:22:28 -04:00
2021-10-31 08:51:51 -04:00
* [Cactus Comments ](https://cactus.chat/docs/integrations/hugo/ ) (Open Source, Matrix appservice, Docker install)
* [Commento ](https://commento.io/ ) (Open Source, available as a service, local install, or docker image)
2023-09-24 05:54:45 -04:00
* [Giscus ](https://giscus.app/ ) (Open source, comments system powered by GitHub Discussions)
2021-10-31 08:51:51 -04:00
* [Graph Comment ](https://graphcomment.com/ )
* [Hyvor Talk ](https://talk.hyvor.com/ ) (Available as a service)
2019-10-21 04:22:28 -04:00
* [IntenseDebate ](https://intensedebate.com/ )
2022-11-17 10:14:29 -05:00
* [Isso ](https://isso-comments.de/ ) (Self-hosted, Python) ([tutorial][issotutorial])
2019-10-21 04:22:28 -04:00
* [Muut ](https://muut.com/ )
2021-10-31 08:51:51 -04:00
* [Remark42 ](https://remark42.com/ ) (Open source, Golang, Easy to run docker)
2022-11-17 10:14:29 -05:00
* [ReplyBox ](https://getreplybox.com/ )
2021-10-31 08:51:51 -04:00
* [Staticman ](https://staticman.net/ )
2022-09-13 14:34:24 -04:00
* [Talkyard ](https://blog-comments.talkyard.io/ ) (Open source, & serverless hosting)
2020-03-31 16:10:45 -04:00
* [Utterances ](https://utteranc.es/ ) (Open source, GitHub comments widget built on GitHub issues)
2019-10-21 04:22:28 -04:00
[configuration]: /getting-started/configuration/
2022-04-28 05:52:15 -04:00
[disquspartial]: /templates/internal/#disqus
2019-10-21 04:22:28 -04:00
[disqussetup]: https://disqus.com/profile/signup/
[forum]: https://discourse.gohugo.io
[front matter]: /content-management/front-matter/
[kaijuissue]: https://github.com/spf13/kaiju/issues/new
[issotutorial]: https://stiobhart.net/2017-02-24-isso-comments/
[partials]: /templates/partials/
[MongoDB]: https://www.mongodb.com/
[tweet]: https://twitter.com/spf13
