MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Release status: stable
Implementation Skin
Description Allows using themes of skins
Author(s) Ryan Schmidt
Jack Phoenix
Samantha Nguyen
Latest version 2.2.3
MediaWiki 1.39+
License Public domain
(the main PHP file is PD-licensed, while some of the actual theme files may not be)
Example ShoutWiki
Quarterly downloads 54 (Ranked 119th)
Public wikis using 1,276 (Ranked 164th)
Translate the Theme extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The Theme extension allows loading of themes (preset CSS to change the appearance of a skin). Users can determine their preferred theme by configuring this in their preferences. The $wgDefaultTheme variable can be used to control what theme is being used site-wide, and the usetheme=X parameter is accepted on a request to change the theme on a per-pageload basis.

This extension was written by Skizzerz for ShoutWiki.


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


$wgDefaultTheme controls which theme is displayed by default when users visit your wiki.

Available themesEdit

For Gamepress
  • blue
  • green
  • orange
For MonoBook
  • dark
  • pink
  • stellarbook
For Vector
  • dark
  • deepsea

Adding themesEdit

To add a new theme for a core skin (such as Modern or Vector), create a directory called skinname (i.e. vector) under $IP /extensions/Theme, place the CSS file(s) there and register the new theme in Theme/extension.json file, under ResourceModules object.

To add a new theme for a custom skin, register a module for each theme in the skin's main setup file. The naming convention is themeloader.skins.skinname-in-lowercase.themename-in-lowercase; for example, the module name of the AutumnLeaf theme for the BlueCloud skin would be themeloader.skins.bluecloud.autumnleaf.