hugo/docs/content/en/content-management/comments.md
Joe Mooring 2eca1b3cc1 hugolib: Deprecate .Site.DisqusShortname
Use .Site.Config.Services.Disqus.Shortname instead.
2023-10-18 17:35:54 +02:00

2.9 KiB

title description keywords categories menu toc weight aliases
Comments Hugo ships with an internal Disqus template, but this isn't the only commenting system that will work with your new Hugo website.
sections
content
organization
project organization
docs
parent weight
content-management 220
true 220
/extras/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:

{{< code-toggle file="hugo" >}} [services.disqus] shortname = 'your-disqus-shortname' {{</ code-toggle >}}

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: