Documentation

Komently Docs

Everything you need to integrate a powerful comment system into your website in minutes.

Overview

Komently is a modern, embeddable comment engine built with Functional Minimalism and a Premium Minimalist aesthetic. Each section is identified by a unique publicId.

It handles real-time threading, voting, and commenter identity out of the box, allowing you to focus on your core product.

Quick Integration

Drop the Komently script into your page:

index.htmlHTML

<!-- Coming Soon: CDN SDK -->
<script src="https://komently.vercel.app/sdk/komently.js" defer></script>

<div id="komently-container" data-public-id="your-unique-id"></div>

Or use the native React component:

CommentArea.tsxtsx

import { CommentSection } from "@/components/comment-section";

export default function Page() {
  return (
    <CommentSection 
      publicId="blog-post-42" 
      apiKey="your-api-key"
      baseUrl="https://komently.vercel.app"
      pageSize={10} 
    />
  );
}

Commenter Profiles

Komently provides a built-in authentication flow for commenters. Users can sign in to participate in threaded discussions, upvote high-quality content, and manage their identities.

Persistent Identity

Commenters maintain their username and activity across your entire platform.

Authenticated Voting

Votes are tied to commenter accounts, preventing spam and ensuring data integrity.

API Reference

GET/api/comments/{publicId}

fetch-commentsbash

curl https://komently.vercel.app/api/comments/demo \
  -H "x-commenter-token: <your_jwt>"

Response format:

response.jsonJSON

{
  "comments": [...],
  "totalPages": 5,
  "totalCount": 42,
  "page": 1
}

Query Parameters

Param	Default	Description
`pageSize`	5	Comments per page
`sorting`	top	Sort: top \| new \| old
`page`	1	Pagination start index

Ready to deploy?

Your first property is free forever. Start building your next great community today.

Access Dashboard