Reports Configuration
About Reports
Section titled “About Reports”What are reports?
Section titled “What are reports?”Reports in the context of a Discord bot are submissions made by users to notify server moderators of inappropriate behavior, messages, or activities within the server.
These reports help maintain community standards by allowing moderators to review and take appropriate action against violations, ensuring a safe and respectful environment for all members.
The workflow
Section titled “The workflow”Before each report-process is started, the following data is checked:
- Is the author blacklisted?
- Is the user immune?
- Has the server, user, or author reached a limit?
Configuration
Section titled “Configuration”Configure
Report Limits
Section titled “Report Limits”| Limit | Explanation | Min / Max configurable | Default |
|---|---|---|---|
| Open reports a user can create | The number of reports that are still open and where the author is the user | 1 - 100 | 5 |
| Max open reports per user | The number of reports that are still open and where the target is the user | 1 - 100 | 1 |
| Max open reports in the server | The number of open reports in the whole server | 1 - 1000 | 20 |
Limits for the limits may change when SupportMail Diamond is introduced.
Limits examples
Example 1:
- User A has created
5reports that are still open. - The “Open reports a user can create” limit is set to
5. - User A tries to create a new report.
User A cannot create a new report because they have reached the limit of open reports they can create.
Example 2:
- User B has
3open reports against them. - The “Max open reports per user” limit is set to
3. - User C tries to create a new report against User B.
User C cannot create a new report against User B because User B has reached the limit of open reports against them.
Example 3:
- The server has
20open reports. - The “Max open reports in the server” limit is set to
20. - User D tries to create a new report.
User D cannot create a new report because the server has reached the maximum number of open reports allowed.
Report Actions
Section titled “Report Actions”Moderators can take actions on reports to manage and resolve them. The available actions include:
| Action | Description |
|---|---|
| Ignore* | Dismiss the report without taking any action. implies that the report has been rejected |
| Resolve (without action)* | Mark the report as resolved after taking appropriate action on the reported issue. implies that the report has been handled in another way |
| Timeout | Timeout the user min-max: 10 seconds - 28 days |
| Kick | Remove the user from the server |
| Ban | Permanently ban the user from the server |
| Delete Reported Message | Delete the message that was reported |
* These actions are always available, even if you disable actions in the Dashboard.
Immune Entities
Section titled “Immune Entities”You can configure certain users and roles to be immune from being reported. This means that reports against these entities will show an error to the user trying to report them, indicating that they cannot be reported.
Moderators
Section titled “Moderators”By default, everyone with at least Timeout members permissions can take action on a report. Kick and ban require the user to also have the respective permission.
Mods also bypass the report limit you’ve manually configured. (the hard limits still apply)
Special Channels
Section titled “Special Channels”You can configure specific channels in your server to be excluded/included from reporting.
If you include channels, reports can only be created in those channels.
If you exclude channels, reports cannot be created in those channels.
You cannot configured both at the same time - you need to choose one or the other.