MediaWiki extensions manual
Release status: stable
Implementation Database
Description Service for detecting possible child exploitation content
Author(s) Trust and Safety Product Team
Maintainer(s) Trust and Safety Product Team
Latest version 2.0.0
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.42
PHP 7.4+
Database changes Yes
Composer mediawiki/media-moderation
Tables mediamoderation_scan
License GNU General Public License 2.0 or later
  • $wgMediaModerationPhotoDNAUrl
  • $wgMediaModerationPhotoDNAMockServiceFiles
  • $wgMediaModerationThumbnailWidth
  • $wgMediaModerationAddToScanTableOnUpload
  • $wgMediaModerationRecipientList
  • $wgMediaModerationPhotoDNASubscriptionKey
  • $wgMediaModerationDeveloperMode
  • $wgMediaModerationFrom
  • $wgMediaModerationHttpProxy
Quarterly downloads 5 (Ranked 129th)
Public wikis using 908 (Ranked 292nd)
Translate the MediaModeration extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The MediaModeration extension is for detecting possible child exploitation content.

See the MediaModeration Wikitech entry for notes on how this extension works in Wikimedia production.



The purpose of the extension is to improve the Foundation’s existing workflows for child protection content.

Prior to deployment of this extension, when the Foundation receives a report of images that depict child sexual abuse, the images are deleted from the projects and reported to law enforcement according to legal requirements. This setup requires volunteers, who unlike staff have no professional training or mental health support, to initially deal with this very emotionally taxing content.

This extension aims to protect the community from being exposed to such content in nearly all cases and get it off the platform a lot faster. It would check images against a database of hashed, known images of child sexual abuse and notify Foundation staff of hash matches to allow Foundation staff to remove the images and report their existence to law enforcement.

This extension does not automatically remove any content without human review by Foundation staff.



MediaModeration provides the following:

  • Check uploaded image against PhotoDNA
  • Send email to pre-configured recipients if suspicious content found



Before installation, the PhotoDNA subscription key should be obtained from Microsoft.


  • Download and move the extracted MediaModeration folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MediaModeration
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'MediaModeration' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.