Guide
Set up logging
The log channel is where SfwBot tells your moderators what it did and why. Logging is on by default, but nothing is posted until you choose a channel. Each entry has buttons to undo a decision or to act on the member.
Before you start
Pick or create a channel that only your moderators can see. Log entries name members and can link to the media that was removed, so the channel should not be public.
SfwBot needs two permissions in that channel: View Channel and Send Messages. If you restricted the channel to a staff role, add the bot's role to it as well.
For an overview of the feature see logging.
Set it up in the dashboard
The [settings reference](/docs/settings) lists the logging options and their defaults.
Open Logging
In the dashboard, open your server and go to Logging.
Choose the channel
Under Log channel, keep Post log messages on and pick the Channel. The page tells you if the bot is missing a permission there.
Decide whether media is included
Include media in log messages adds the removed image or video to the entry so a moderator can judge it. Switch it off if your moderators should not see the content again.
Save and send a test message
Choose Save changes, then use Test message. A short message appears in the log channel, sent the same way real entries are.
Set the language
Log entries use the server language. Change it under General if it should differ from your server's Discord language.
The `/settings` command
/settings has the page Logging, where you pick the log channel, switch the media preview on or off and disable logging. When you pick a channel, the bot checks its permissions there and tells you what is missing. It needs the Manage Server permission.
The /setup wizard asks for the log channel as its first step. See getting started and the command reference.
What is logged
Removed media
Every image, GIF or video blocked by nudity detection or your block list, with the level that was found.
Invites
Messages removed by the invite filter.
Spam
Messages removed by the spam filter, with the check that fired.
Blocked links
Links found by link protection, whether or not the message was deleted.
AutoMod
Messages blocked by an AutoMod rule that SfwBot manages.
Trust and strikes
Every change of a member's trust and every strike. See trust and strikes.
Permission problems
A notice when the bot could not delete a message because a permission is missing.
Credit notices
A warning when your credits run low and a notice when they are used up.
Acting on a log entry
Log entries have buttons, so a moderator can act without leaving the channel:
| Button | What it does |
|---|---|
| Report as wrong | Reports a wrong removal by the model to the SfwBot team for review |
| Allow in this server | Adds the image to your allow list |
| Remove from block list | Takes an image off your block list after a wrong match |
| Delete message | Deletes the message, when automatic deletion is off |
| Timeout, Kick, Ban | Acts on the member, after a confirmation |
| Take back | Takes back a trust violation, including a strike it caused |
Every button needs the Manage Server permission. For Timeout, Kick and Ban the moderator also needs the matching Discord permission (Timeout Members, Kick Members or Ban Members) and a role above the member's highest role. The bot needs the same permission and a role above the member's as well. The server owner cannot be timed out, kicked or banned this way.
If you prefer to review before anything is removed, switch off automatic deletion in nudity detection. The entry then asks for a decision instead of reporting one.
The activity log in the dashboard
The dashboard page Activity log shows what happened on your server as a list you can filter by kind of event, time range and channel. It also records changes to your settings, so you can see who changed what.
The activity log does not need a log channel. It is not a replacement for one either: only the log channel reaches your moderators as it happens.
How long log data is kept
Messages in your log channel stay there until you delete them; they are ordinary Discord messages.
What SfwBot itself stores from a member's message, such as the link to the media, its fingerprint and the reason for a removal, is deleted after 30 days. See security and privacy.
Troubleshooting
- Nothing is posted. No log channel is set. The dashboard overview and the pages of the modules show a warning in that case.
- The bot cannot post in the channel. Give it View Channel and Send Messages there. The Logging page and
/statusboth show what is missing. - The log channel was deleted. The Logging page says so. Pick a new channel.
- Entries arrive without the media. Include media in log messages is off, or the entry is about a text filter.
- A button does nothing or shows an error. You need Manage Server. For Timeout, Kick and Ban you also need the matching Discord permission and a role above the member's, and so does the bot.
- Entries are in the wrong language. Set the server language under General.
Common questions
Can I use more than one log channel?
No. A server has one log channel for all modules. AutoMod has a separate alert channel, where Discord posts its own notices.
Do members see the log?
Only if they can see the channel. Restrict it to your moderators.
Does the bot still act without a log channel?
Yes. Messages are still removed. Your moderators are just not told about it.