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.