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.

Field
Report User (Context)
Report Message (Context)
/report user
/report message

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.

Actions can be disabled if you want to handle reports in a different way.

Action
Description

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


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.

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.

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)

Report limits

To avoid abuse, there are 3 types of limits that can be configured and are set by default.

Limit
Explanation
Min / Max configurable
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?