Modbot Docs
Moderation

Reports

What members tell the mods with /report or the Report to mods menu in Discord, the Reports page where staff read and close them, who sees who reported, and how long the words are kept.

A member who sees something wrong in your Discord server can tell the mods without telling anyone else. They run /report, or right-click a message and pick Report to mods. Their report lands on the Reports page in Modbot, under Community, for the staff who handle it.

Both are off until you turn them on: Settings → Discord → Commands, report and Report to mods. See the bot's commands.

What a member sees

  • /report member: what: takes a member picked from Discord's list and what happened, 1 to 1,000 characters.
  • Report to mods, under Apps on a message, opens a form asking What's wrong?, 1 to 1,000 characters. The report is about the message's author, and Modbot keeps a copy of the message.

Every reply is visible only to them. A report is accepted with "Sent to the mods." and is refused, in plain words, when:

WhyWhat they are told
It is about themselvesYou can't report yourself.
It is about Modbot, or about one of Modbot's own messagesYou can't report Modbot.
They already reported this messageYou already reported this.
They already have an open report on this personThe mods already have your report.
They made 3 reports in the last 10 minutes, or 10 in the last daySlow down. Try again in a few minutes.

The limits are per person, counted from the reports Modbot has kept, so restarting Modbot does not reset them. Nothing is limited for the server as a whole. The person reported is never told, and nobody in the server can see that a report was made or by whom.

The Reports page

Open and Closed tabs; the Open tab carries how many are waiting, and so does the Reports entry in the sidebar. Each report shows:

  • when it was made;
  • who it is about, as a link to their profile;
  • what the member wrote;
  • the message they reported, with its channel, when it was sent, its words and the names of any files attached (Discord's links to the files expire, so only the names are kept);
  • Reported by, with the member's Discord name and id;
  • Open in Discord, which opens the message there;
  • Add note, Watch and Profile, which open the person's popup, for the people who hold those permissions;
  • Close, with a Close note that is required. The note is kept on the report, with who closed it and when. Tell the reporter is optional: see Telling the reporter.

Closing is recorded in the audit log as Member report closed, naming the person reported and the staff account that closed it. The note is not in the entry.

Telling the reporter

When you close a report you can send the reporter a Discord direct message, so they know it was handled. Under Tell the reporter pick one of:

  • Don't tell them, the default: nothing is sent.
  • one of your ready-made messages, which fills the box so you can change it before you close;
  • Write my own, and write the message yourself (at most 1,000 characters).

The message goes to the reporter alone, as a direct message from the bot. It is never posted in a channel, and nothing in Discord names who reported. Modbot keeps only whether it went: a closed report says The reporter was told., or The reporter was not told with the reason (their direct messages may be closed, or they may share no server with the bot). A message that fails to send does not undo the close. Modbot keeps no copy of what was sent, and the reporter's id is in no audit log entry. Without a Discord bot token (Settings → Discord) the form says the reporter can't be messaged.

Set the ready-made messages in Settings → Discord → Report replies: up to 10, each with a name (40 characters) and the message (1,000 characters). It needs Change settings.

Who sees who reported

Everyone who can open the page sees who reported: moderators need to ask follow-up questions and to spot somebody reporting out of spite. Nobody else does:

  • Not Discord: no reply, card or message names the reporter.
  • Not a notification: Modbot: new report says "Somebody reported a member." with a link to the page, and no names. It goes by email, Discord direct message or push, as each person set up their own notifications, to people who hold See reports, and at most one every 15 minutes.
  • Not the audit log: Member report made names the person reported and the report's id, and nothing the member wrote or quoted. Running /report or the menu is not recorded as Discord command used, because that entry would name the member. Who may see Member report made is under Reports about staff.

Reports about staff

A report about somebody whose Discord account is connected to a Modbot staff account is shown only to people who also hold Review tickets, the permission the people being reviewed are not meant to hold. For everyone else it is not in the list, not in the count beside Open, and not in the sidebar's number, and the notification for it goes only to people who hold both permissions. It follows the same rule as Reviews.

The two entries it leaves, Member report made and Member report closed, follow the same rule. When the person reported is a staff account, they are shown only to people who hold Review tickets as well as See the operational log: not in the audit log, not in that person's timeline, not on the live feed, in webhooks or on the live updates stream. Someone who holds the operational log alone still sees these entries for everyone else, and every other operational entry.

Permissions

PermissionAllows
See reportsOpen the page, read the reports, see who reported, and the count in the sidebar.
Handle reportsClose a report. Needs See reports as well.

Both are in the built-in Moderator role. See Roles and permissions.

What Modbot keeps

Each report is one row in Modbot's database:

  • the reporter's Discord id and name when they reported;
  • the reported person's Discord id and name, and the VRChat account linked to them then;
  • what the reporter wrote;
  • for the menu: the message's id, the channel's id and name, when it was sent, its words, the names of its files, and its link;
  • open or closed, who closed it, when, and the close note;
  • whether the reporter was told when it was closed, and if not, why. Not what was sent.

Closed reports keep the words for a year. After the number of days in Settings → Server → Keep for (days) → Closed reports (365 unless you change it; 0 keeps them forever) from the day a report was closed, Modbot removes what the member wrote and the copy of the message. The record stays: who reported, who it was about, when, who closed it, and the close note. The page then shows Removed. where the words were. An open report is never removed.

A purge of a person deletes every report they made and every report made about them. Nothing about a report is sent to Modbot Cloud or to an AI chat tool in this version.

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.

On this page