Flags
The Flags page lists what your moderation rules caught in Discord messages and VRChat profiles, filters them by language, and lets you dismiss a flag for good or send it to Reviews.
A flag is a note Modbot writes when one of your AutoMod rules matches some text: a Discord message, or a VRChat user's display name, bio, status or pronouns. The Flags page lists them so a moderator can read each one and either leave it or dismiss it.
| To | You need |
|---|---|
| Open the Flags page | See profiles |
| Press Dismiss, Open a review or Ask AI | Review tickets |
A flag is a note, not a finding. Nobody is judged by it.
What raises a flag
Flags only come from AutoMod rules, set up under Settings, AutoMod. There are two kinds of rule:
- Term lists: words, phrases or patterns. They are matched inside Modbot and send nothing to an AI provider.
- AI topics: something to catch, described in your own words. Modbot asks your AI model whether the text matches.
Nothing is flagged until AutoMod and at least one rule are switched on. Discord messages are checked as the bot stores them; VRChat profiles are checked when Modbot first records a profile and whenever part of it changes. The details are on AutoMod.
The same rule and term on the same message, or on the same words in the same part of a profile, is only flagged once.
Not the same as Flagged on Live
The Flagged mark on the Live page comes from your group's flag rules. An AutoMod flag nobody dismissed is one of them, and can be turned off there.
Reading the page
There are three tabs: Open, with the number waiting, Dismissed, and Confirmed. Each shows the newest 200 flags. The same number of open flags is beside Flags in the sidebar, and while any are open the browser tab's title starts with it, as (3) Modbot (added to the open reviews, if you can see those).
When the flags are in more than one language, a row of buttons above the list filters by language, with the number of flags in each.
Each flag shows:
- Who. Click the name to open their popup: a person popup for a VRChat user, or that person's popup from their Discord account.
- Where. A VRChat or Discord badge, and what was checked: Discord messages, Display name, Bio, Status or Pronouns.
- The language of the text that was checked, or Unknown when it was too short to tell.
- Which rule, by name.
- What the rule did, when it was set to act on Discord messages: Message deleted and Timed out with how long; on a VRChat profile, Banned from the group or Removed from the group.
- Exempt, when the person is one the rule never acts on: a member of your team, or somebody who holds a role the rule spares (see AutoMod). The rule flagged them and nothing was done.
- The matched words, in quotes. For a term list, the term that matched follows in grey. When a picture matched instead, a Picture badge and the picture's name, which links to it.
- The messages before it, when the rule was set to send them, so you can see what the model saw.
- The reason, when there is one: a Modbot Hub term's note, or the AI model's one-sentence explanation.
- When it was flagged. On the Dismissed and Confirmed tabs, also who decided it and when.
- AI call, on a flag an AI topic raised: a link to that call in the call log, where you can read exactly what the model was sent and what it answered.
The list and the count redraw by themselves when a rule raises or settles a flag.
Dismissing a flag
Press Dismiss beside an open flag. A confirmation names the person and the rule; press Dismiss again to confirm, or Cancel. The flag moves to the Dismissed tab. If Modbot cannot dismiss it, the confirmation stays open and says why.
Dismissing is permanent for that person
Once dismissed, that rule and that term (for an AI topic, that topic) never flags that person again, and never deletes their messages or times them out again. Other terms in the same list, and other rules, still apply to them. There is no way to undo a dismissal in the app.
Dismissing does not undo anything the rule already did. A deleted Discord message stays deleted and a timeout runs its course.
Dismiss a flag when the rule got it wrong for this person: a name that only looks like a slur, a joke between friends, a word that means something else in their language. If the flag was right, leave it open, or act on it in Discord or VRChat as you normally would.
Every dismissal is recorded in the audit log against your account, with the rule, the term and the matched words.
Sending a flag to Reviews
Press Open a review beside an open flag to hand it to your team's Reviews page. A rule can also be set to open a review for every flag it raises.
Closing that review asks which way it went. The rule was wrong dismisses the flag, with everything that means above. The rule was right confirms it: the flag moves to the Confirmed tab, and the rule's card counts it beside its dismissal rate.
Good to know
- A rule that is mostly dismissed is mostly noise. The Term lists and AI topics cards in Settings show how often each rule has flagged, how many of those were dismissed, how many were confirmed, and the dismissal rate for each language separately.
- Deleting a term list or topic keeps the flags it already made.
- A rule starts as flag only, and most rules stay that way. A rule that has been set to act can delete a Discord message or time its author out, and can ban somebody from your VRChat group or remove them from it. It never kicks or warns anybody, and it never acts across platforms: a bio match never deletes a message, and a message never bans anybody from the group. See Actions.
AutoMod
Term lists and AI topics that check Discord messages and VRChat profiles, what a rule can do about a match, the AI tools AutoMod may use, the messages before the one being checked, pictures, the language on each flag, test sets, the trial before a rule acts, channel and role limits, the daily AI call limit and the Try it box.
Auto-invites
Having Modbot invite people to your group once they have spent long enough in one of your instances and pass your rules.