Moderation

Block users, mute/ban users in threads, and report messages

📄️ Block user

Blocks a user from sending messages to the current user. Blocked users cannot start new conversations or send messages in existing conversations with the blocker. Users cannot block themselves or administrators. Role-based restrictions and immunity rules are applied via the `restrictBlockUsers` and `restrictBlockUsersImmun` settings.

📄️ Unblock user

Removes a block on a previously blocked user, allowing them to send messages again. The user must have been blocked first.

📄️ Mute user in thread

Mutes a user within a specific thread, preventing them from sending messages for an optional duration. Requires moderator permission in the thread. The target user must be a current participant. When a duration is specified, the mute automatically expires after the given number of seconds.

📄️ Unmute user in thread

Removes a mute restriction from a user in a thread, allowing them to send messages again. Requires moderator permission.

📄️ Ban user from thread

Bans a user from a thread — removes them as a participant and prevents them from rejoining. Requires moderator permission. When a duration is specified, the ban automatically expires after the given number of seconds. The user is immediately removed from the thread upon banning.

📄️ Unban user from thread

Removes a ban restriction from a user, allowing them to rejoin the thread. Requires moderator permission. Note that unbanning does not automatically re-add the user as a participant — they must rejoin or be re-invited.

📄️ Report message

Reports a message for moderator review. Each user can only report a specific message once. Users cannot report their own messages. The report category must be one of the allowed categories (default: inappropriate, spam, harassment, offensive, other — customizable via the `better_messages_get_report_reasons` filter). The description is limited to 500 characters by default (customizable via filter).

📄️ Get report reasons

Returns available report reason categories for a specific message. Also checks whether the current user has already reported this message — returns an error if they have. The default categories are inappropriate, spam, harassment, offensive, and other, but they can be customized via the `better_messages_get_report_reasons` filter.