Add comments

How to empower readers to engage with your content?

Wowchemy supports the following comment providers:

  • Twitter and other social networks
    • Option 1: Readers can comment by clicking one of the Page Sharing links such as the Twitter link
    • Option 2: Tweet your page and add a [Comment]( link at the end of the page, referencing your tweet URL. Readers can then comment in the Twitter thread and react by liking or retweeting. You can also embed the Tweet at the end of the article (see Content > Page Elements).
  • Disqus
    • widely adopted but not particularly minimal and may contain adverts
  • Commento
    • privacy focussed with support for threaded Markdown comments

You may also add your own comment provider by overriding the comments file with the code from your provider.

To configure the provider, open config/_default/params.yaml, scroll down to the comments section, and set the provider to the one you wish to use, disqus or commento:

  # Choose a provider: disqus, commento, or '' to disable commenting
  provider: ''
    # Paste the shortname from your Disqus dashboard.
    shortname: ''
    # Show comment count in page header? (true/false)
    show_count: true
    # If you self-host Commento, enter your custom Commento URL here.
    url: ''

For Disqus, copy your shortname from your Disqus admin panel and paste it in the Disqus config section shown above.

Choose where users can comment

Under the comments section, you also have the option to choose which types of pages a user may comment on. Simply add the type of page (if it’s not already in the list) and set its value to true to enable comments. For example,

    post: true # Blog posts
    book: true  # The Book type is used for any project docs and online courses
    project: true # Portfolio projects
    publication: true # Publication (e.g. journal) pages
    event: true

Alternatively, you can make page specific exceptions to this rule by adding commentable: true (or false) to the front matter of a page that you wish to enable/disable comments on.