comments.md (2954B)
1 ---
2 title: Comments
3 linktitle: Comments
4 description: Hugo ships with an internal Disqus template, but this isn't the only commenting system that will work with your new Hugo website.
5 date: 2017-02-01
6 publishdate: 2017-02-01
7 lastmod: 2017-03-09
8 keywords: [sections,content,organization]
9 categories: [project organization, fundamentals]
10 menu:
11 docs:
12 parent: "content-management"
13 weight: 140
14 weight: 140 #rem
15 draft: false
16 aliases: [/extras/comments/]
17 toc: true
18 ---
19
20 Hugo ships with support for [Disqus](https://disqus.com/), a third-party service that provides comment and community capabilities to websites via JavaScript.
21
22 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].
23
24 ## Add Disqus
25
26 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].
27
28 ### Configure Disqus
29
30 Disqus comments require you set a single value in your [site's configuration file][configuration] like so:
31
32 {{< code-toggle copy="false" >}}
33 disqusShortname = "yourDisqusShortname"
34 {{</ code-toggle >}}
35
36 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:
37
38 * `disqus_identifier`
39 * `disqus_title`
40 * `disqus_url`
41
42 ### Render Hugo's Built-in Disqus Partial Template
43
44 Disqus has its own [internal template](https://gohugo.io/templates/internal/#disqus) available, to render it add the following code where you want comments to appear:
45
46 ```
47 {{ template "_internal/disqus.html" . }}
48 ```
49
50 ## Alternatives
51
52 These are some alternatives to Disqus:
53
54 * [Cactus Comments](https://cactus.chat/docs/integrations/hugo/) (Open Source, Matrix appservice, Docker install)
55 * [Commento](https://commento.io/) (Open Source, available as a service, local install, or docker image)
56 * [Graph Comment](https://graphcomment.com/)
57 * [Hyvor Talk](https://talk.hyvor.com/) (Available as a service)
58 * [IntenseDebate](https://intensedebate.com/)
59 * [Isso](https://posativ.org/isso/) (Self-hosted, Python) ([tutorial][issotutorial])
60 * [Muut](https://muut.com/)
61 * [Remark42](https://remark42.com/) (Open source, Golang, Easy to run docker)
62 * [Staticman](https://staticman.net/)
63 * [Talkyard](https://www.talkyard.io/blog-comments) (Open source, & serverless hosting)
64 * [Utterances](https://utteranc.es/) (Open source, GitHub comments widget built on GitHub issues)
65
66 [configuration]: /getting-started/configuration/
67 [disquspartial]: /templates/internal/#disqus
68 [disqussetup]: https://disqus.com/profile/signup/
69 [forum]: https://discourse.gohugo.io
70 [front matter]: /content-management/front-matter/
71 [kaijuissue]: https://github.com/spf13/kaiju/issues/new
72 [issotutorial]: https://stiobhart.net/2017-02-24-isso-comments/
73 [partials]: /templates/partials/
74 [MongoDB]: https://www.mongodb.com/
75 [tweet]: https://twitter.com/spf13