Content Comments
Leave editorial notes on any entry, resolve threads when the feedback is actioned, and optionally receive email notifications so nothing slips through the cracks.
The comments panel
Open any entry in the editor. A Comments tab appears in the right-hand panel alongside Meta and Activity. Each comment shows the author's username, timestamp, and body text. Resolved comments are dimmed and can be toggled on or off.
Adding a comment
- Open an entry and click the Comments tab in the editor panel.
- Type your note in the text area at the bottom and press Add comment.
- The comment is saved immediately and, if email notifications are enabled, an email is sent to all users who have opted in.
Resolve and unresolve
Click the Resolve button next to any open comment to mark it as actioned. Resolved comments are hidden by default; toggle Show resolved to bring them back. Clicking Unresolve reopens the thread. Any user can resolve or unresolve any comment.
API
| Endpoint | Action |
|---|---|
GET /api/collections/:id/entries/:slug/comments | List all comments for an entry (open and resolved) |
POST /api/collections/:id/entries/:slug/comments | Create a new comment { "body": "…" } |
PATCH /api/collections/:id/entries/:slug/comments/:commentId | Resolve or unresolve { "resolved": true } |
DELETE /api/collections/:id/entries/:slug/comments/:commentId | Permanently delete a comment (author or admin only) |
A GET response looks like:
[
{
"id": "c_01j…",
"username": "alice",
"body": "Please shorten the intro paragraph.",
"resolved": false,
"created_at": "2026-05-20 10:14:00"
}
] Email notifications
When a comment is posted, Orbiter can notify all users by email. To enable this:
- Go to Settings → Notifications.
- Enable Comment notifications (
notify_comment = 1). - Ensure SMTP is configured under Settings → Email.
SMTP configuration
All outgoing email — including comment notifications — is sent through your own SMTP server. Configure it in Settings → Email:
| Setting | Description |
|---|---|
smtp_host | SMTP server hostname |
smtp_port | Port — typically 587 (STARTTLS) or 465 (SSL) |
smtp_user | SMTP username / login |
smtp_pass | SMTP password or app password |
smtp_from | From address shown in delivered email |
Orbiter does not store or queue email — delivery is attempted immediately when the comment is created. If SMTP is not configured, notifications are silently skipped.