Manual:Skin configuration

This page contains comprehensive information for administrators on how to configure skins on a wiki. Please refer to Help:Skins for general skin information and Manual:Skinning for developer information on creating new skins.

Set a Default Skin for a Wiki
A default skin can be set for new users of a wiki by setting the variable $wgDefaultSkin in LocalSettings.php to the lowercase skin name specified in the skin file. Users can still change their skin later by going to their preferences page. To change all existing users' skin settings, use the userOptions.php maintenance script. The syntax to use on the command line would be:

$ php userOptions.php skin --old --new

Example:

$ php userOptions.php skin --old "monobook" --new "modern"

Suppression of Skins
The administrator can limit the skin choices that are offered site-wide in user's preferences by listing skin(s) to suppress in the $wgSkipSkins array. To do this, put something like this in LocalSettings.php:

Site-Wide CSS
MediaWiki allows administrators to specify site-wide CSS rules to be added to every page rendered. These rules can be added by editing the page MediaWiki:Common.css. See the rules for this page for example.

User CSS
Users can also specify their own CSS rules by creating the page "User:Username/skinname.css". If a user uses the monobook skin for example, they would edit the page Special:MyPage/monobook.css. This feature can be enabled by setting $wgAllowUserCss to true in LocalSettings.php.

1.14 and newer
Set $wgAllowUserSkin to false in LocalSettings.php. This will remove the "Skin" tab from preferences and the possibility to use the useskin parameter in the URL.

1.13 and older
The system administrator can completely remove the Skin tab/link so that it does not show up at all in User Preferences. This makes sense if your site will use a customized skin and would not look right in any other skin.

To remove the Skin link/tab from User Preferences, go in includes/specials/SpecialPreferences.php and comment out (put another # at the beginning of each line or put /* before the first line and */ after the last line) these lines (starts on line ~815, ends on line ~843): It is also possible to just remove all the choices for skins, except for one: see $wgSkipSkin and $wgDefaultSkin.