Audit log
Complete logging of all relevant server events
The audit log automatically writes Embed reports to configured channels whenever something noteworthy happens on your server — from a deleted channel to a role update. The 23 events are grouped into three categories so you can maintain separate channels for message, member, and server events.
Setup
- Enable the audit log module
- Create three dedicated log channels (recommended: #log-messages, #log-members, #log-server)
- Assign the three channels in the dashboard: messages channel, members channel, server channel
- Enable events: toggle all 23 events individually or by category
- Optional: configure ignored channels and ignore-bots setting
- Save
You can route all three categories to the same channel. Separate channels make the log much easier to read.
All 23 events
Category: messages
- messageUpdate — Message edited — shows original and new text
- messageDelete — Message deleted — shows content (if in cache)
- inviteCreate — Invite created — shows link, creator, and expiry date
Category: members
- guildMemberAdd — User joined — with account age and creation date
- guildMemberRemove — User left (voluntarily or via kick)
- guildBanAdd — User banned — with reason if available
- guildBanRemove — User unbanned
- memberMuteTimeout — User silenced via Discord timeout
- memberUnmuteTimeout — User timeout lifted
- memberNicknameUpdate — Nickname changed — old and new shown side by side
- userUpdate — User profile changed (avatar, global name)
- memberRolesUpdate — Roles added or removed — shows diff
- voiceJoin — User joins a voice channel
- voiceLeave — User leaves a voice channel
- voiceMove — User switches voice channel (from → to)
Category: server
- roleCreate — New role created
- roleUpdate — Role edited (name, colour, Permissions)
- roleDelete — Role deleted
- channelCreate — New channel created
- channelUpdate — Channel edited (name, Permissions, topic)
- channelDelete — Channel deleted
- guildUpdate — Server settings changed (name, icon, description)
- emojisUpdate — Emojis added or removed
Configuration options
Ignored channels: message events from specific channels are not logged. Useful for very active bot channels.
Ignore bots: bot actions (e.g. when a bot deletes a message) are hidden from the log. Default: ON.
Each event category can be routed to a different channel. If you do not assign a messages channel, message events will not be logged — even if they are enabled.
Recommended configuration
- Create three separate private channels visible only to mods: #log-messages, #log-members, #log-server.
- Enable all 23 events initially, then disable only what creates too much noise (e.g. voiceJoin/Leave on large servers).
- Add very active channels (e.g. bot playground, #spam-off) to the ignore list.
Frequently asked questions
- Why is the content missing for deleted messages?
- Discord only includes the message content if it is in the bot's internal cache. Messages older than approximately 30 minutes, or messages the bot has not seen since a restart, will appear without content.
- Can I disable the audit log for specific roles?
- Not per role, but you can use "Ignore bots" to hide all bot actions. There is no targeted suppression for user roles.
- Are audit log Embeds themselves written to the audit log? (recursion?)
- No. The bot recognises its own actions and suppresses recursive logging.
- How long are logs stored in Discord?
- Discord has no automatic message deletion. The Embeds remain in the channel until they are manually deleted or removed via bulk delete.