Background
Some communities want incident reports to be sent by email rather than posted publicly on-wiki. Redirecting users to external email workflows is inconsistent, harder for users, and gives us little confidence that a report was actually sent. A built-in form allows IRS to support email-based reporting in a structured and measurable way.
User Story
As a user seeking help, I want to be able to submit a report directly through a form within IRS that sends my report to a community-configured email address, so that I can report an incident easily without needing to navigate external workflows or use my own email client.
Requirements
Add a direct reporting option where IRS collects the report details in a form and sends them directly to a predefined community-configured email address.
- Intended flow:
- User selects a category in IRS
- User clicks submit
- Support page is open with option for webform enabled
- User completes and submits the form
- IRS sends the submitted content to a predefined email address
- The form should clearly indicate that submitting it will send the report to the relevant community email address.
- The email sent should contain the following info (see current formatting of emergency flow):
- Username of reporter
- Username of person reported (if reporting from DiscussionTools menu)
- Link to reported comment (if reporting from the DiscussionTools menu
- Type of behaviour reported (category)
- Details (as filled in by reporter)
- Special:EmailUser link of reporter
- CommunityConfig
- direct reporting for email is added as an option in community config
- if direct reporting is selected the other support options are hidden
- direct reporting is replacing the mailto option for all categories EXCEPT Doxing and Something Else (see below)
- Doxing category
- direct reporting should be the only option available under the "How to request help" (see designs)
- recipient email should default to stewards-oversight@wikimedia.org
- If admins configure a new email address this should override the default address (stewards)
- Something Else category
- no direct reporting should be included as the users already have the free text box
- This should be enabled for all wikis
Designs
| Page | Visuals | Notes | Figma link |
| Category selection | Copy changes from previous version of this page. Refer to Figma for details. | Figma | |
| Direct reporting page | Page title is different from standard support page. | Figma | |
| Form submit confirmation | Figma | ||
| Form submit error | Figma | ||
| Community config example | Copy changes from previous version of this page. Refer to Figma for details. | Figma | |
| Doxing category | |||
| Page | Visuals | Notes | Figma link |
| Direct reporting page | This visual example shows the page with the warning message and oversight policy link enabled | Figma | |
| Doxing community config | Figma | ||
Acceptance criteria
- A user can submit the form and the email is sent to the desired destination






