Skip to content

Comments

Comments are the discussion tool for posts. They support threading, media attachments, reactions, and pinning.

Leaving a Comment

The comment form is below each post. Supported features:

  • Text message
  • Media file upload (images)
  • User mentions via @username (with autocomplete)

Create comment: POST /comments (rate limit — 30 requests per minute).

Replies

Users can reply to a specific comment — the reply is displayed as a nested thread. Comment threads form a hierarchical structure with parent (parent_id) and root (branch_id) references.

Comment Editing

The administrator can set a time window for editing via Admin Panel → Content (/admin-panel/settings/content) → Comment edit time (minutes).

After this time expires, the comment cannot be changed.

Pinning a Comment

The post author or a moderator can pin one comment at the top of the discussion section. The pinned comment is visually highlighted.

Reactions on Comments

Users react to comments via POST /reaction — same as for posts. Available reactions are configured in Admin Panel → Reactions (/admin-panel/like-reactions).

Deleting a Comment Thread

A moderator or author (within their permissions) can delete not just an individual comment but an entire thread (DELETE /comments/{comment}/branch/destroy).

Commenting Restrictions

Admin Panel → Content (/admin-panel/settings/content) → Commenting restrictions allows:

  • Preventing unregistered users from commenting
  • Requiring email verification to comment
  • Restricting commenting for new accounts

Comment reports and moderation are covered in Moderation.

Moderation Status

StatusDescription
PublishedVisible to all
In moderationHidden until reviewed
Deleted (soft delete)Hidden, marked as deleted

Notifications

A user receives a notification when:

  • Someone replies to their comment
  • Someone mentions them via @username
  • Their comment receives a reaction

Released under the MIT License.