Documentation
Everything you need to embed, configure, and manage comments on your site.
Quick Start
Add the script tag to any HTML page:
<script async
src="https://cdn.example-comments.com/embed.js"
data-site="YOUR_SITE_PUBLIC_KEY">
</script>The widget will create a #comments-root container automatically
and render at the bottom of <body>. To control placement,
add the container yourself:
<div id="comments-root"></div>Script Attributes
| Attribute | Required | Description |
|---|---|---|
data-site | Yes | Your site's public key from the admin dashboard. |
data-page | No | Override the page identifier (defaults to location.pathname). |
data-api-base | No | API base URL. Use for local or staging environments. |
data-theme | No | light, dark, or auto (default). |
data-view | No | tree (threaded) or flat (chronological). |
data-unstyled | No | Set true to disable built-in styles. |
Admin API
All admin endpoints live under /v1/ and require a bearer token.
See the OpenAPI spec for the full reference.
Webhooks
Register a webhook URL in the dashboard to receive real-time events. The
payload follows an envelope schema with type,
version, and data fields.
Feedback