Every Suspend, Ban, and Shadow-Ban form now requires two fields:
- Reason — the text the user sees in their email and on
/bannedor/suspended. Usually comes from a template. - Moderator note — internal only. Goes to the Moderator Notes panel on the user's admin page via
ModNote::create.
Leave the note blank and the form rejects with an error. Also applies in the moderation queue at /admin/moderation/{id}.
What to write in the note. The user-facing reason is usually a template citation. The mod note is for why this action, not a lighter one — the specific post(s), prior history, any appeal-eligibility thinking. If a Sysop reviews your decision later (appeals or routine audits), this note is what they'll read to decide whether to reverse.
The shadow-ban sidebar toggle prompts for a note via a browser dialog when enabling. Removing a shadow ban doesn't require one.