Manual:$wgDefaultUserOptions

Users: $wgDefaultUserOptions
Settings added to this array will override the default user preferences used by anonymous visitors and newly created accounts.
Introduced in version:	1.4.0
Removed in version:	still in use
Allowed values:	See below.
Default value:	See below.

Other settings: Alphabetical | By Function

Details

Settings in this array will override the default user preferences for anonymous visitors and users who have not customized their preferences.

Available preferences

The following user preferences are available for customisation:

Name	Description
User Profile
fancysig	If User uses a custom (raw) signature (0 or 1). If user has not set a custom signature, their signature is controlled by the contents of the wiki page mediawiki:Signature or mediawiki:Signature-anon. If user has specified a custom sig, the actual text of the signature is in the nickname option.
rememberpassword	Whether to remember the user's password between sessions.
enotifwatchlistpages	Only used if $wgEnotifWatchlist is set.
enotifusertalkpages	Only used if $wgEnotifUserTalk is set.
enotifminoredits	Only used if $wgEnotifWatchlist and $wgEnotifUserTalk are set.
enotifrevealaddr	Only used if $wgEnotifRevealEditorAddress and either $wgEnotifWatchlist or $wgEnotifUserTalk are set.
Quickbar
quickbar	Quickbar location (only applies if using Cologne Blue or Classic skins). Options are: 0 - None, 1 - Fixed left, 2 - Fixed right, 3 - Floating left, 4 - Floating right, 5 (since 1.19) - Left/right depending on your language.
Skin
skin	Which skin to use. May be false to indicate that the site default (as defined in $wgDefaultSkin) should be used.
Math
math	How to render in-line maths (contents of <math></math> tags). Only applies if $wgUseTeX is set. Options are: 0 - Always render PNG, 1 - HTML if very simple or else PNG, 2 - HTML if possible or else PNG, 3 - Leave it as TeX (for text browsers), 4 - Recommended for modern browsers, 5 - MathML if possible (experimental)
Files
imagesize	Size to limit images on description pages to. Values correspond to the entries in $wgImageLimits. By default, 2 is 800*600.
thumbsize	Thumbnail size - Values Correspond to the entries in $wgThumbLimits. By default, 2 is 180px.
Date and Time
date	Date format. Options: 'default': No preference 'mdy': 16:12, January 15, 2001 'dmy': 16:12, 15 January 2001 'ymd': 16:12, 2001 January 15 'ISO 8601': 2001-01-15T16:12:34
timecorrection	Timezone offset
Editing
rows	Edit box size (rows)
cols	Edit box size (columns)
editsection	Enable section editing via [edit] links
editsectiononrightclick	Enable section editing by right clicking on section titles (JavaScript)
editondblclick	Edit pages on double click (JavaScript)
editwidth	Edit box has full width
showtoolbar	Show edit toolbar (requires javascript)
previewonfirst	Show preview on first edit
previewontop	Show preview before edit box
minordefault	Mark all edits minor by default
externaleditor	Use external editor by default
externaldiff	Use external diff by default
uselivepreview	Only used if $wgLivePreview is true.
forceeditsummary	Prompt user when entering a blank edit summary
Recent changes
rcdays	Days to show in recent changes
rclimit	Titles in recent changes
hideminor	Hide minor edits in recent changes
shownumberswatching	Show the number users, who are watching this page (on recent changes, watch list and artice pages). Only used if $wgRCShowWatchingUsers is set.
usenewrc	Enhanced recent changes - javascript collapsable tree
hidepatrolled	Hide patrolled changes in Recent changes
newpageshidepatrolled	Hide patrolled pages from New pages
Watchlist
watchlistdays	Number of days to show in watchlist (cannot exceed $wgRCMaxAge)
extendwatchlist	Expand watchlist to show all applicable changes
wllimit	Number of edits to show in expanded watchlist (if 'extendwatchlist' == 1)
watchlisthideown	Hide the user's own edits from the watchlist
watchlisthidebots	Hide bot edits from the watchlist
watchlisthideminor	Hide minor edits from the watchlist
watchcreations	Add pages the user creates to their watchlist
watchlisthideanons	Hide anonyms' changes from the watchlist
watchlisthideliu	Hide logged users' changes from the watchlist
watchlisttoken	Token of watchlist
watchlisthidepatrolled	Hide patrolled changes from the watchlist
watchdefault	Add pages the user edits to their watchlist
watchmoves	Add pages the user moves to their watchlist
watchdeletion	Add pages the user deletes to their watchlist
Search
searchlimit	Hits per page
contextlines	Lines per hit
contextchars	Context per line
ajaxsearch	Enables AJAX Search (Options are 1 for true and 0 for false)
Misc
stubthreshold	Threshold for stub display
underline	Whether to underline links. Options are: 0 - never, 1 - always, 2 - browser default
highlightbroken	Format broken links as red-underlined links (alternative: with a questionmark as the link, like this?).
justify	Justify paragraphs
language	User specific interface language, especialy usefull in conjuction with $wgHiddenPrefs. Note:This is not to set the wiki's default language. Use $wgLanguageCode instead.
numberheadings	Option "Auto-numbering Headings", 1 turns on the numbering of all headings within articles
showtoc	Boolean. 1 is show the TOC, 0 is hide it.
nocache	Disable page caching
showhiddencats	Show hidden categories
showjumplinks	Enable "jump to" accessibility links
diffonly	Don't show page content below diffs
norollbackdiff	No diff after rollback

Notes:

• 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.
• This list is not up to date with the latest MediaWiki Version. List options with --list.

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 quickbar 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 DefaultSettings.php.

From version 1.19 (r91432), 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.

Example

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

$wgDefaultUserOptions['editsection'] = 0;

See also

• userOptions.php - Changing the user options of existing users
• $wgNamespacesToBeSearchedDefault
• $wgHiddenPrefs

Language:	English  • 日本語