Skip to main content
Mod logs record server events and moderation actions in a channel you choose. Each enabled event posts a color-coded embed with a short summary plus structured fields, so moderators can scan what happened without opening Discord audit logs. Most events now include who performed the action (the actor) by cross-referencing Discord’s audit log. This requires the View Audit Log permission — check Permissions if actor fields aren’t showing.

Configure mod logs

1

Open the dashboard

Go to the BrewBot Dashboard and select your server.
2

Navigate to Mod Logs

Open the Mod Logs page from the sidebar.
3

Select a log channel

Choose the channel where the bot should post log entries. You can also create a new #mod-logs channel directly from the dashboard.
4

Enable logging

Turn on the Enable Audit Logging toggle.
5

Choose events to log

Enable the event categories you want to track. Each event has its own toggle, so you can keep the log channel focused on what your team actually reviews.
Enable only the events you care about. Message edits, deletions, and high-churn channel updates can make the log channel noisy if you turn everything on at once.

Additional settings

  • Ignore bots — skips events when the affected user is known to be a bot
  • Hide user thumbnails — removes user avatars from member, message, and voice embeds
  • Ignored channels — skips message delete and message edit logs for the channels you exclude

Event reference

Each log entry uses a color to signal what kind of action happened:
  • 🟢 Green — joins, creates, unbans, and other positive or additive events
  • 🟡 Yellow — edits, updates, moves, and changed settings
  • 🔴 Red — leaves, deletes, bans, and removals
  • 🔵 Blue — informational events such as invite creation
  • 🟠 Orange — reserved for moderation warning-style events

Member events

Logs when a member joins the server.

Message events

Logs when a message is deleted. Ignored channels are skipped.

Role events

Logs when a role is created.

Channel events

Logs when a channel is created.

Voice events

Logs when a member joins a voice channel.

Server events

Logs when server settings change.

Default settings

Moderation events such as Member muted, Member unmuted, Moderation ban, and Moderation unban are enabled by default in the dashboard configuration. The current event-driven log output described on this page focuses on the handlers already implemented by the bot, while all other toggles start disabled until you opt in.