Add comments to Hugo in 5 minutes

Add zero-JS comments to your Hugo site in 5 minutes.

1. Deploy the Worker

npx ziscus deploy --ssg hugo --site-url https://yoursite.com

This creates the D1 database, deploys the Worker, generates your admin secret, and scaffolds the Hugo partial.

2. Add the partial to your layout

The deploy command creates layouts/partials/ziscus-comments.html. Include it in your single post layout:

{{ "{{" }} partial "ziscus-comments.html" . {{ "}}" }}

Place it where you want comments to appear, typically after .Content in layouts/_default/single.html.

3. Enable AI spam filtering (optional)

npx ziscus ai-mod enable

Workers AI catches spam before it reaches your site. ~3,000 classifications per day on the free tier.

4. Auto-rebuild on new comments

Add a GitHub Actions workflow so your site rebuilds when comments are posted. See the rebuild setup guide.

That's it

Comments are anonymous, zero-JS, and stored in your own Cloudflare D1 database. Moderate via CLI:

npx ziscus mod-log                  # view moderation history
npx ziscus ai-mod status            # check AI stats

Back to ziscus.com | Compare to other systems | GitHub