DOC.01
Getting started
- Add Sift. Use the invite link. It asks only for the permissions it uses: managing messages, timeouts, kicks, bans, channels for lockdown and appeal tickets. It never asks for Administrator.
- Run
/setup. The server owner picks a log channel for case cards and a mod role. Everything else has a sensible default. - Move Sift's role up. In Server Settings → Roles, drag Sift above the roles it should be able to time out or ban. Discord doesn't let a bot act on anyone ranked above it.
- Leave it running. After a day or two,
/statsshows what it caught and how often your mods agreed.
Optional channels in /setup: an event log (edits, deletes, joins, role changes), an urgent channel that pings your mod role for the most serious cases, and a private channel for members who may need support.
DOC.02
How Sift decides
Every message goes through two layers.
1. Instant rules
Lookalike and known scam links, spam floods, the same link posted across channels, and your own blocklist are handled on the spot. These never use a smart check, so they keep working when your monthly checks run out.
2. The smart check
Everything else is read together with the few messages before it, so friendly trash talk isn't treated like a real attack. Spaced-out letters, lookalike characters and words split across several messages are joined back up first. The result is one of three outcomes:
- Pass. Nothing happens and the message isn't stored.
- Review. Sift isn't sure. The message stays up and a case card goes to your log channel.
- Block. Clearly over the line. The message is deleted, the member gets a strike, and a case is logged.
Members who seem to be in a bad place are never answered in public. Your mods get a private heads-up in the support channel instead.
DOC.03
Cases and the mod panel
Each case card shows the message, why it was flagged, and the member's recent history, with buttons to approve, warn, time out or ban. Use /modpanel to work through open cases one at a time, or /cases list to search old ones.
Approving a case tells Sift it got that one wrong. The overturn rate in /stats is the quickest way to see whether your thresholds need adjusting.
DOC.04
Strikes
Blocked messages add strike points. By default, 3 points is a timeout, 14 a kick and 20 a ban, and points expire after 30 days. Change the points, the steps or the expiry in /settings, or switch the ladder off and handle everything by hand.
Leaving and rejoining doesn't clear a timeout: Sift puts it back when they return.
DOC.05
Raids and mass deletes
When lots of accounts join in a short window (6 in 30 seconds by default), your mods get an alert that lists the new accounts. Turn on auto-lockdown in /settings and Sift also locks every text channel. /lockdown locked:false scope:server puts every channel back exactly as it was.
If anyone other than the owner deletes channels or roles, or bans members, in a rapid burst, Sift stops them, even if they have the permissions to do it.
DOC.06
Appeals
A member who was banned, kicked or timed out can DM Sift and run /appeal. That opens a private ticket channel with your team. Banned members are let back in to a restricted role while the appeal is reviewed, so they can only see their ticket.
Approving lifts the action. Rejecting ends the ticket, and they have to wait before appealing again.
DOC.07
Tuning it for your server
- Too many flags? Raise the review threshold in
/settings, or add the phrase your server keeps using to the allowlist. - Missing things? Lower the thresholds, or add exact phrases to the blocklist for instant deletes.
- Quiet channels. Exempt channels and roles (a staff channel, a bot-command channel) so Sift ignores them.
- Categories. Switch individual categories off. Child safety and member-support checks always stay on.
DOC.08
Sift Max features
Your own rules
/rules add takes a rule in plain English, like "No asking for game account logins". Choose whether a break is flagged for review or deleted with a strike. Up to 10 rules per server.
Server network
Link up to 5 servers you own with /network create and /network join. A ban in one is copied to the rest after a short delay, blocklists merge, and a raid on one warns the others. A burst of bans isn't copied, in case an admin account has been taken over. Unbanning someone where the ban started lifts the copies too.
Deeper context
Reads the last 25 messages instead of 6, and double-checks anything flagged or close to the line before acting.
Weekly report and export
A summary lands in your log channel every Monday with a CSV of the week's cases. /cases export downloads any period on demand.
DOC.09
Command reference
Setup
/setupOpens the setup panel: log channels, mod role and the basics.
Server owner/settingsEvery setting in one panel: categories, thresholds, strikes, raid protection, exemptions.
Manage ServerReviewing
/modpanelStep through open cases one at a time.
Mods/case idLook up one case by its id.
Mods/cases listRecent cases. Filter by status, type, member, outcome or time.
Mods/cases clearPermanently delete this server's case history.
Mods/stats periodWhat was caught, what was done, and how often mods overturned Sift.
Mods/appeals statusBrowse appeals by status.
ModsActions
/warn user reasonWarn a member. They get a DM and a case is logged.
Mods/timeout user durationTime out for 60 seconds up to a week.
Mods/untimeout userLift a timeout early.
Mods/kick userKick a member, with a DM and a case.
Mods/ban userBan anyone by id, even if they've left. Can also clear their recent messages.
Mods/unban userUnban by id.
Mods/purge countBulk-delete up to 100 recent messages in this channel.
Mods/slowmode secondsSet slowmode here. 0 turns it off.
Mods/lockdown locked scopeLock or unlock this channel, or every channel.
ModsMembers
/warnings userA member's history. Members can see their own.
Everyone/strikes view | resetSee or clear a member's strike points.
Mods/appealAppeal a ban, kick or timeout. Run it in a DM with Sift.
Everyone/verifyCheck or finish verification.
EveryonePlans
/premium statusThis server's plan and smart checks used this month.
Mods/rules add | remove | listYour own plain-English rules. Max.
Manage Server/network create | join | leave | statusLink servers you own. Max.
Server owner/report now | weeklyPost the weekly report now, or turn the Monday report on or off. Max.
Manage Server/cases export sinceDownload cases as a CSV file. Max.
Mods