Docs Features Guide Logging System

Logging System

Track server events with 36 event types, per-event channel routing, and detailed audit logs through the dashboard

logging logs audit events member message voice channel role invite emoji server

Overview

The logging system records server events and posts detailed log entries to designated channels. Navigate to Left sidebar > Logging on your server dashboard to configure all settings. The module supports 36 individual event types organized into seven groups: member events, role events, channel events, message events, voice events, server events, and emoji events. Each event can be toggled independently and optionally routed to a different log channel using channel overrides.

Enabling and Basic Setup

Navigate to Left sidebar > Logging on your server dashboard. Toggle the enabled switch at the top of the page to activate the module.

channelId (channel picker): Select the default log channel where all event logs are sent. This is the primary destination for log messages unless you configure per-event channel overrides. The bot needs View Channel and Send Messages permissions in the selected channel.

Once enabled and a channel is selected, you can toggle individual event types below. No events are enabled by default — you choose exactly which events to track.

Member Events

Nine events for tracking member activity:

memberJoin (toggle): Logs when a new member joins the server. Includes account creation date and join position.

memberLeave (toggle): Logs when a member leaves or is removed from the server.

memberKick (toggle): Logs when a member is kicked by a moderator. Shows the moderator who performed the action and the reason if provided.

ban (toggle): Logs when a member is banned. Includes the moderator and ban reason.

unban (toggle): Logs when a ban is lifted from a user.

nicknameChange (toggle): Logs when a member changes their server nickname. Shows the old and new nickname.

avatarChange (toggle): Logs when a member updates their server avatar.

memberTimeout (toggle): Logs when a timeout is applied to a member. Shows the duration and moderator.

timeoutRemove (toggle): Logs when a timeout is removed from a member before it expires.

Role Events

Five events for tracking role changes:

roleCreate (toggle): Logs when a new role is created on the server. Includes the role name, color, and permissions.

roleDelete (toggle): Logs when a role is deleted from the server.

roleUpdate (toggle): Logs when a role's properties are modified, such as name, color, or permissions changes.

roleGiven (toggle): Logs when a role is assigned to a member. Shows who received the role and who assigned it.

roleRemoved (toggle): Logs when a role is removed from a member.

Channel Events

Seven events for tracking channel and thread changes:

channelCreate (toggle): Logs when a new channel is created. Includes channel type, name, and category.

channelDelete (toggle): Logs when a channel is deleted from the server.

channelUpdate (toggle): Logs when a channel's settings are modified, such as name, topic, or slowmode changes.

channelPerms (toggle): Logs when channel permission overwrites are added, removed, or modified.

threadCreate (toggle): Logs when a new thread is created in any channel.

threadDelete (toggle): Logs when a thread is deleted or auto-archived.

threadUpdate (toggle): Logs when a thread's properties are changed, such as name, archive status, or slowmode.

Message Events

Three events for tracking message activity:

messageDelete (toggle): Logs when a message is deleted. Includes the message content, author, and channel. Attachments are noted but cannot be recovered.

messageEdit (toggle): Logs when a message is edited. Shows both the original content and the updated content side by side.

messagePurge (toggle): Logs when multiple messages are bulk-deleted using a purge or clear command. Shows the count and the channel where messages were removed.

Voice Events

Four events for tracking voice channel activity:

voiceJoin (toggle): Logs when a member joins a voice channel.

voiceLeave (toggle): Logs when a member leaves a voice channel.

voiceMove (toggle): Logs when a member moves between voice channels. Shows the source and destination channels.

voiceStatus (toggle): Logs when a member's voice state changes, such as muting, deafening, or streaming status updates.

Server and Invite Events

Three events for tracking server-level changes:

serverUpdate (toggle): Logs when server settings are modified, such as name, icon, verification level, or region changes.

inviteCreate (toggle): Logs when a new invite link is created. Includes the inviter, target channel, and expiration settings.

inviteDelete (toggle): Logs when an invite link is deleted or expires.

Emoji Events

Three events for tracking custom emoji changes:

emojiCreate (toggle): Logs when a new custom emoji is added to the server.

emojiDelete (toggle): Logs when a custom emoji is removed from the server.

emojiUpdate (toggle): Logs when a custom emoji is renamed.

Channel Overrides

By default, all enabled events send logs to the main channelId channel. Channel overrides let you route specific event types to different channels.

channelOverrides (per-event channel picker): For each event type, you can optionally select a different channel. For example, you might send member join/leave logs to a #member-logs channel while sending message delete/edit logs to a #message-logs channel. Leave the override empty to use the default log channel.

This is useful for high-volume servers where separating log types into dedicated channels makes it easier to find specific entries and prevents important logs from being buried in a flood of messages.

Tips

Start by enabling the most critical events: memberJoin, memberLeave, ban, messageDelete, and messageEdit. These provide essential moderation visibility. Use channel overrides to separate high-volume events like message edits from low-volume events like role changes. Enable inviteCreate and inviteDelete together with memberJoin to track which invite link each new member used. Keep voice events in a separate channel if your server has active voice usage, as voiceJoin and voiceLeave can generate high volume. The channelPerms event is particularly useful for detecting unauthorized permission changes on sensitive channels.