Add comments to Astro in 5 minutes

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

1. Deploy the Worker

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

This creates the D1 database, deploys the Worker, generates your admin secret, and scaffolds the Astro component.

2. Use the component

The deploy command creates src/components/ZiscusComments.astro. Import it in your blog post layout:

---
import ZiscusComments from '../components/ZiscusComments.astro';
---

<article>
  <slot />
</article>
<ZiscusComments slug={Astro.props.slug} />

The component fetches comments at build time and renders them as static HTML. No client JavaScript.

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