Jump to content


From mediawiki.org
MediaWiki extensions manual
Release status: experimental
Implementation Parser extension , Media
Description Hide media that may make readers uncomfortable
Author(s) 沈澄心talk
Latest version 0.1.0
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.41.0
License GNU General Public License 2.0 or later
  • $wgMediaSpoilerEnableMark
Quarterly downloads 0
Translate the MediaSpoiler extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The MediaSpoiler extension allows editors to mark sensitive media and make them hidden by default. It also gives users an option to show/hide all media.


Add |class=spoiler to images/videos you want to hide (only works with images/videos with |frame or |thumb options). It adds notpageimage class to those media automatically, excluding them from page image candidates.

Registered users can change the “Media display” option to choose to hide sensitive media, show all media, hide all media, or show links to media description pages only by default (the latter three are still available when $wgMediaSpoilerEnableMark = false.


  • Download and move the extracted MediaSpoiler 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/MediaSpoiler
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'MediaSpoiler' );
  • Configure as required.
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.



Allow editors to mark sensitive media. If set to false, |class=spoiler option will not hide media (but still exclude media from page image candidates), and “Hide media marked as sensitive” option will be unavailable. Default value: true