Page MenuHomePhabricator

Implement email direct reporting for IRS
Closed, ResolvedPublic

Description

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
PageVisualsNotesFigma link
Category selection
IRS-enwiki-category selection.png (720×2,092 px, 166 KB)
Copy changes from previous version of this page. Refer to Figma for details.Figma
Direct reporting page
IRS-enwiki-direct-reporting-form.png (720×2,610 px, 207 KB)
Page title is different from standard support page.Figma
Form submit confirmation
IRS-enwiki-form-confirmation.png (720×1,620 px, 82 KB)
Figma
Form submit error
IRS-enwiki-form-error.png (720×2,898 px, 230 KB)
Figma
Community config example
IRS-enwiki-community-config.png (2,960×1,138 px, 124 KB)
Copy changes from previous version of this page. Refer to Figma for details.Figma
Doxing category
PageVisualsNotesFigma link
Direct reporting page
Doxing-direct-reporting.png (360×1,209 px, 77 KB)
This visual example shows the page with the warning message and oversight policy link enabledFigma
Doxing community config
Doxing-community-config.png (882×606 px, 53 KB)
Figma
Acceptance criteria
  • A user can submit the form and the email is sent to the desired destination

Event Timeline

@Madalina I’ve added design visuals and links to the task description.

Madalina updated the task description. (Show Details)

Change #1286282 had a related patch set uploaded (by STran; author: STran):

[mediawiki/extensions/ReportIncident@master] Update copy per new specs

https://gerrit.wikimedia.org/r/1286282

Change #1286282 merged by jenkins-bot:

[mediawiki/extensions/ReportIncident@master] Update copy per new specs

https://gerrit.wikimedia.org/r/1286282

Change #1282321 had a related patch set uploaded (by STran; author: STran):

[mediawiki/extensions/ReportIncident@master] Allow email direct reporting from IRS (front-end)

https://gerrit.wikimedia.org/r/1282321

Change #1288523 had a related patch set uploaded (by STran; author: STran):

[mediawiki/extensions/ReportIncident@master] Allow email direct reporting from IRS (back-end)

https://gerrit.wikimedia.org/r/1288523

Change #1282321 merged by jenkins-bot:

[mediawiki/extensions/ReportIncident@master] Allow email direct reporting from IRS (front-end)

https://gerrit.wikimedia.org/r/1282321

Change #1288523 merged by jenkins-bot:

[mediawiki/extensions/ReportIncident@master] Allow email direct reporting from IRS (back-end)

https://gerrit.wikimedia.org/r/1288523

Change #1293662 had a related patch set uploaded (by STran; author: STran):

[operations/mediawiki-config@master] Enable IRS Direct Reporting on testwiki

https://gerrit.wikimedia.org/r/1293662

Change #1293662 merged by jenkins-bot:

[operations/mediawiki-config@master] Enable IRS Direct Reporting on testwiki

https://gerrit.wikimedia.org/r/1293662

Mentioned in SAL (#wikimedia-operations) [2026-05-26T13:25:40Z] <stran@deploy1003> Started scap sync-world: Backport for [[gerrit:1293662|Enable IRS Direct Reporting on testwiki (T425025)]]

Mentioned in SAL (#wikimedia-operations) [2026-05-26T13:27:35Z] <stran@deploy1003> stran: Backport for [[gerrit:1293662|Enable IRS Direct Reporting on testwiki (T425025)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-05-26T13:35:08Z] <stran@deploy1003> Finished scap sync-world: Backport for [[gerrit:1293662|Enable IRS Direct Reporting on testwiki (T425025)]] (duration: 09m 28s)