From mediawiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: experimental
Implementation User interface
Description Adds a link to a wiki's personal URLs list to toggle dark mode
Author(s) (MusikAnimaltalk)
Latest version 0.0.1
Compatibility policy Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.29+
Database changes No
License MIT License
Translate the DarkMode extension if it is available at translatewiki.net

Check usage and version matrix.

Issues Open tasks · Report a bug

The DarkMode extension adds a link to the top toolbar to toggle a dark mode theme.


  • Download and place the file(s) in a directory called DarkMode in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'DarkMode' );
  • Configure as required.
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


Dark Modes works by adding the CSS filter: invert( 1 ) hue-rotate( 180deg ) to the HTML element, and then applies some refinements to MediaWiki UI elements.

Excluding elements from dark mode[edit]

On your wiki, you can add the mw-no-invert CSS class to any element that you don't want inverted. Or you could use the same filter CSS above again, which will invert and rotate the elements back to normal.

Styling elements in dark mode[edit]

Dark Mode adds the darkmode CSS class to the HTML element. If you want to change the way some elements look in dark mode, just prefix the selector with .darkmode.