Badges and pinned comments

Enabled by default:

'badges' => [
    'enabled' => true,
    'pins' => true,
    'author_key' => 'user_id',
    'moderator_ids' => [],
],

GET ui exposes features.badges and features.pins. The SDKs and Blade partials (commentify-pro::partials.badges, pin-button) follow those flags.

Badges

Badge	How it is decided
Author (OP)	Comment `user_id` matches `commentable->commentifyAuthorId()`, or the attribute named in `badges.author_key` (default `user_id`)
Staff / moderator	Comment author passes `isCommentifyModerator()` or is in `moderator_ids`
Guest	`user_id` is null (`isGuest()`)

public function commentifyAuthorId(): int
{
    return $this->author_id;
}

Guest comments (user_id null) never get the author badge even if names match. JSON: is_author, is_moderator, is_guest.

Pins

One parent comment per thread. Pinning another parent clears pinned_at on the previous. Replies cannot be pinned (cannot_pin_reply).

POST   /commentify/api/v1/comments/{id}/pin
DELETE /commentify/api/v1/comments/{id}/pin

Moderators only (ModeratorGate). pins false → 404. List endpoints call pinnedFirst() so the pinned comment stays on top regardless of sort. Filament’s moderation queue has Pin / Unpin. The kebab menu in the thread shows pin when you are a moderator (demo personas: Maya / Aisha on commentify.pro/login).

Last modified on September 12, 2026

Getting Started

Usage

Frontends

API

Moderation

Features

Help

Badges and pinned comments

Badges

Pins

​Badges

​Pins

Badges

Pins