🚩 Reports & Vote Ban
Reports and Vote Ban put your community's eyes to work. Reports let any member flag a message for admin review — with optional automatic action once enough members agree. Vote Ban goes a step further, letting the community itself vote to remove a problematic member.
Overview
- Members report a message with
/reportor right-click → Apps → Report Message - Admins get a review embed with one-click Ban, Delete, and Ignore actions
- A report threshold can trigger automatic action once enough unique members report
- Vote Ban posts a public vote with Ban and Save buttons, with configurable thresholds, windows, and immunity
Configuration
To configure both systems:
- Open your project in the Fren One webapp.
- Select the Discord server you want to configure.
- In the sidebar under Agent Configuration, select Moderation, then the Reports & Vote Ban tab.
The tab stacks two independent sections, each with its own master toggle and save.
Reports
Toggle "Allow members to report messages" on.
Automatic action
| Option | Description |
|---|---|
| Action on Report Threshold | What happens when enough members report the same message: No automatic action (notify only), Warn (default), Mute (timeout), Kick, or Ban. |
| Mute duration | Shown when the action is Mute. 1 second up to 28 days; default 1 hour. Required. |
| Reports Before Action | How many reports trigger the action. Minimum 1; default 3. |
Review notifications
"Send review notifications to" controls where the review embed goes:
| Option | Description |
|---|---|
| A dedicated channel | Default. Reveals a Report channel picker (required). |
| DM specific roles | Reveals Roles to DM — members with these roles get the review DM. Leave empty to DM the server owner. |
| The reported message's channel | Posts the review in the same channel as the reported message. |
A read-only list below shows recent reports (up to 30; empty state "No reports").
Vote Ban
Toggle "Let members vote to ban problematic members" on.
Vote thresholds
| Option | Description |
|---|---|
| Votes needed | Ban votes required to trigger the action. Minimum 1; default 5. |
| Max votes per member | How many times one member can vote in a session. Minimum 1; default 1. |
| Vote window (minutes) | How long a vote stays open. Default 30. 0 = never expires. |
| Cooldown (seconds) | Minimum time between vote sessions per member. Default 300. |
Outcome
| Option | Description |
|---|---|
| Action | Ban (default), Kick, or Mute (timeout). |
| Mute duration (days) | Shown when the action is Mute. 0–28; default 0, where 0 = Discord's maximum (28 days). |
| Let members vote to save the target | Default: on. Reveals Saves needed — counter-votes required to cancel a ban. Minimum 1; default 3. |
| Delete the target's recent messages | Reveals Delete message history (days) — 1–7; default 7. |
Who can vote
| Option | Description |
|---|---|
| Who can start and cast votes | Everyone (default), Only specific roles (reveals Allowed roles), or Everyone except specific roles (reveals Excluded roles). |
| Immune roles | Members with any of these roles can't be targeted. |
A read-only list below shows recent vote sessions (up to 20; empty state "No vote ban sessions").
How it works in Discord
Reporting: a member right-clicks a message → Apps → Report Message, or uses /report with the message link. Admins then receive the review embed — in the report channel, by DM, or in the message's channel — with four buttons: Ban + Delete Msg, Ban + Purge 7d, Delete Message, and Ignore. If the same message collects the configured number of reports from unique reporters, the automatic action fires on top.
Vote Ban: a member starts a session via right-click → Apps → Vote Ban, or /voteban with a message link. The agent posts a public vote message with Ban and Save buttons. If ban votes reach Votes needed within the window, the action runs; if saves reach Saves needed first, the session is cancelled.
Saving your changes
Each section uses a batched save — edits stay local until you select Save in the bar that appears at the bottom of the page. Leaving the page with unsaved changes shows a warning first.
Best practices
- Use a dedicated, admin-only report channel so review embeds (and their one-click ban buttons) aren't public.
- Keep Action on Report Threshold at Warn or notify-only until you trust the signal — reports can be weaponized in disputes.
- Leave the save vote on and keep Immune roles covering admins and trusted members so vote bans can't hit your own team.
- A vote Cooldown stops one member from spam-starting sessions against everyone they argue with.
The review embed's Ban + Delete Msg and Ban + Purge 7d buttons act immediately. Route review notifications somewhere only trusted admins can see.
Troubleshooting
Nobody receives review notifications?
- With A dedicated channel selected, a Report channel must be set and the agent must be able to post there.
- With DM specific roles and no roles selected, the review goes to the server owner's DMs — check there.
A vote ban ended without any action?
- The session may have hit Saves needed counter-votes, or the Vote window expired before Votes needed was reached.
- The target may hold an Immune role.
Members can't start a vote?
- Check "Who can start and cast votes" and the per-member Cooldown between sessions.