Manual:$wgDefaultUserOptions

To add a new user preference, see:

The below changes to LocalSettings.php will override the default user preferences for anonymous visitors and users who have not customized their preferences.

Existing user accounts who had the (previous) default option and didn't set it explicitly (which means that it's not stored in the database) will then use the new default.

Note: in the old preferences system, the change affects only anonymous visitors (if relevant) and new accounts.

Available preferences
The following user preferences are available for customization:

Notes: This list is not up to date with the latest MediaWiki Version. List options with --list (see ).
 * New settings are added to MediaWiki periodically. Some of these settings have been added since $wgDefaultUserOptions was introduced in v1.4.0. Currently there is no documentation about when settings were added.
 * It is possible for extensions and language files to add extra toggles to the 'misc' tab. Languages that use this feature should have the setting described here. Extensions should add the information to their extension page.

Gadget options
gadget-$gname e.g. gadget-HotCat for MediaWiki:Gadget-HotCat.js

Default values
Each language sets its own default values for the user preferences in its language file.

For example languages that read right-to-left will probably set the  to appear on the right, instead of on the left.

The values added to $wgDefaultUserOptions are overrides, i.e. if the value exists here then it will take precedence, but settings may be omitted from the array in which case the language's default value will be used.

In versions of MediaWiki prior to 1.8.0 the default value of this setting was simply an empty array, with the current language providing the default values.

From version 1.8.0 onwards, only the language-specific settings were overridden in the language file, so most settings are now explicitly set in  .

From version 1.19 (), the overrides by the language files were removed because they didn't work, and the features that used them, like quickbar, have been done differently and better.

Examples
To disable section editing links by default (for new and anonymous users), set the following in LocalSettings.php:

 Note: From version 1.23 onwards, the section editing links need to be disabled via site-wide or user CSS, see phabricator>:phabricator:T54811 for details on the change.

Add pages the user edits to their watchlist by default:

If the preference is of type multiselect, things are a bit more complicated.

The key for each default user option is the concatenation of the preference key with the option key.

For example if the preference key is 'favoritecolors' and the option key is 'red', the default user option key would be 'favoritecolorsred'.

In this hypothetical scenario, if you wanted to have red and yellow selected by default, you would use:

If the preference is of type checkmatrix, things are even more complicated.

The key for each default user option is the concatenation of the preference key with the column key and row key, separated with hyphens.

For example if the preference key is 'favoritecars' and the column key is 'red' and the row key is 'corvette', the default user option key would be 'favoritecars-red-corvette'.

In this hypothetical scenario, if you wanted to have red Corvette and black Jetta selected by default, you would use:

When writing a MediaWiki extension, instead of using the global variable $wgDefaultUserOptions, you can add a section to extensions.json: