From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: stable
Implementation Skin
Description Allows using themes of skins
Author(s) Ryan Schmidt
Jack Phoenix
Samantha Nguyen
Latest version 2.1
MediaWiki 1.32+
License Public domain
(the main PHP file is PD-licensed, while some of the actual theme files may not be)
Example ShoutWiki
Hooks used
Translate the Theme extension if it is available at translatewiki.net
Check usage and version matrix.
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' );
  • Yes 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 themes[edit]

For MonoBook
  • dark
  • pink
  • stellarbook
For Vector
  • dark
  • deepsea

Adding themes[edit]

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.