Komments
Sign in Get started
Documentation

Up and running in two minutes.

Everything you need to embed Komments, configure auth, and go live.

Quick start

Add Komments to any HTML page with two lines. No build step required.

1
Create a site in the dashboard

Sign up at admin.komments.io, create a site, and copy your public API key.

2
Drop the snippet where you want comments
HTML
3
Done

Open the page. Comments are live. AI moderation is on by default.

Authentication setup

Komments supports email OTP, GitHub, and Google OAuth out of the box. Configure which providers are enabled from the dashboard under Settings -- Auth.

Enable OAuth providers
  1. Go to Settings -- Auth in the dashboard
  2. Toggle the providers you want to enable
  3. For GitHub/Google: paste in your OAuth app credentials
  4. The widget automatically shows the configured sign-in options
SSO (Business plan)

Pass your own signed JWT to pre-authenticate commenters from your site's existing session:

Customization

Theme the widget to match your site. All customization lives in the dashboard under Appearance.

CSS variables
/* In the dashboard Appearance -> Custom CSS panel */
:host {
  --kmts-accent: #7c3aed;
  --kmts-font-family: 'Inter', sans-serif;
  --kmts-border-radius: 12px;
  --kmts-bg: #0f0f0f;
  --kmts-fg: #ededed;
}

The widget runs in Shadow DOM, so your global styles don't bleed in -- and neither do the widget styles. Set tokens in the custom CSS panel and every component picks them up.

API reference

The REST API gives you full programmatic access. Use it to build custom UIs, sync comments to your CMS, or trigger webhooks on your own infrastructure.

Base URL
https://api.komments.io/v1
GET /sites/:siteId/comments List comments
POST /sites/:siteId/comments Create comment
PATCH /comments/:id/approve Approve comment
DELETE /comments/:id Delete comment

Full API reference is available in the admin dashboard under API Reference.