Reports
What Reports are and how to use them.
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.
How to report someone or some message
Users can use and to report messages and users to the servers' moderators.
Below is shown which kind of data can and has to be given.
user
automatically
automatically
automatically
message / message-link
/
automatically
/
required
reason
required
Proofs
optional
/
optional
/
/
/
/
/
optional
/
optional
Before each report-process is started, the following data is checked:
Is the author blacklisted?
Is the user immune?
Has the guild, user, or author reached a limit?
Report Actions
After every check has passed the report is created and sent into the alert channel and the user's DMs.
The team can then take action on the report.
Ignore *
Ignore the report implies that the report has been rejected
Resolve (without action) *
Resolve the report implies that the report has been handled in anther way
Timeout
Kick
Kick the user
Ban
Ban the user and optionally delete his message history for up to 7 days
Delete reported message
Delete the reported message
Actions with * are always available.
Configuration Options
The Alert Channel
The alert channel is where all reports go. It can be a text channel or any thread channel.
The bot needs some basic permissions for this to work.
Run /debug option:Check permissions to check those permissions.
Immune entities
Configuring entities as immune to reports means setting up specific permissions for certain roles or users so that they are not affected by report and report actions.
This feature allows you to specify which members of your team or community should not be subjected to be reported. It is particularly useful for administrative or moderator roles that require heightened access to perform their duties effectively.
However, if you have a larger team or do not know how they behave, we strongly recommend that you do not configure this option to ensure that no one abuses their rights and breaks rules with impunity.
Excluded / Included channels
By setting channels as excluded, you can prevent reports from affecting trusted users in private channels.
However, you should also be careful on the other side and ensure that the wrong channels are not inadvertently excluded from reports.
Learn how to configure this here: Configuration
Moderator Settings
By default, everyone with at least MODERATE_MEMBERS permissions can take action on a report. Kick and ban require the user to also have the respective permission. They also bypass the report limit you've manually configured. (the hard limits still apply)
To overwrite this, you can set your own moderators. (Users and roles)
When this is set, permissions are ignored completely! So make sure all of your users have the role you configured or are added manually as a user in this setting.
Report limits
To avoid abuse, there are 3 types of limits that can be configured and are set by default.
Open in Guild
The number of open reports in the whole guild
1 - 1000
20
Open reports a user can receive
The number of reports that are still open and where the target is the user
1 - 100
1
Open reports a user can create
The number of reports that are still open and where the author is the user
1 - 100
5
Last updated
Was this helpful?