Moderation Module

Logging

A record of what happens on your server. Route events, member joins, message edits and deletes, role changes, moderation actions, and more, to the log channels you choose.

Where to find it: run /config Category dropdown Moderation Logging. Toggle the module on first.

How it works

You pick a group of events, then pick the channel those events log to. Repeat for as many event/channel pairings as you like, for example send message deletes to #message-logs and member joins to #join-logs.

Good to know

Keep noisy events (message edits/deletes) in their own channel so they don't bury important ones like bans and role changes.

Set up your logs

Choose Configure. Select the events you want to track from the list.
Pick the channel those selected events should be sent to.
Repeat Configure for other event groups you want in different channels.
(Optional) Use Blacklist to stop logging from specific channels, categories, or roles you don't care about.

The bot needs View Channel, Send Messages, and Embed Links in each log channel.

Events you can log

Event	What gets logged
Channels	Channel and category creations, deletions, and updates.
Threads	Thread creations, deletions, and updates.
Pins	Message pins and unpins.
AutoMod	AutoMod rule creations, deletions, and updates.
Emotes	Sticker and emoji creations, deletions, and updates.
Server Events	Scheduled event creations, deletions, and updates.
Server Roles	Role creations, deletions, and updates.
Server Updates	Server setting changes such as icon, vanity, and name.
Soundboard	Soundboard sounds added, deleted, or edited (name, volume, emoji).
Webhooks	Webhook creations, deletions, and updates.
Reactions	Reactions members remove.
Polls	Polls ending.
Messages	Message deletions and edits.
User Roles	Roles added to or removed from members.
User Events	Members subscribing to or leaving scheduled events.
Invites	Invite creations and deletions.
Moderation	Bans, unbans, kicks, mutes, and unmutes.
Join	Member joins, including the join method: the invite code and who made it, your vanity URL, or who added a bot.
Leave	Member leaves.
Boosts	Server boosts and unboosts.
Voice	Members joining, leaving, and switching voice channels.
Avatar	Avatar changes.
Nickname	Nickname changes.
Tag	Members adding or removing the server tag.

To see which invite someone used, the bot needs the Manage Server permission. Without it the join method line is left out. When the bot can't tell which invite was used (for example Server Discovery joins), it shows Unknown.

Reference: all settings

Setting	What it does
Configure	Choose events and assign the channel they log to.
Reset	Remove logging for selected events.
Blacklist	Ignore logs coming from certain channels, categories, or roles.

Troubleshooting

Problem	Fix
An event isn’t logging	Re-open Configure and confirm that event is selected with a channel assigned.
A channel is spamming logs	Add it under Blacklist to ignore events from there.
Nothing logs at all	Check the bot can View/Send/Embed in the chosen log channel.
Join logs have no join method	Give the bot the Manage Server permission so it can read invite uses.