Template:Mbox

{{{text}}}

Template documentation[ view · edit · history · purge ]

This documentation is transcluded from Template:Mbox/doc.

This template is used in system messages. Changes to it can cause immediate changes to the Wikimedia user interface. To avoid major disruption, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Please discuss changes on the talk page before implementing them. Transclusion count: unknown

This is used to create message boxes.

Usage

{{Mbox
 |text =
 |type =
 |image =
}}

Template parameters

Parameter	Description		Default	Status
text	text	The text to be displayed.	empty	required
type	type	Changes the color depending on the message needed. Each has its own preset image, see #Examples	notice	optional
image	left image	Override the image (“none” for no image). Use format: [[File:Commons-emblem-urgent.svg|class=noviewer|48px]]. The default depends on the type.	empty	optional
imageright	right image	Show an image on the right side, similar to the left one (but empty by default).	empty	optional
textstyle	text style	Override/augment default style of text cell (e.g. alignment — text-align:left; / text-align:right; / text-align:center;).	empty	optional
style	box style	Override/augment default style of the whole message box.	empty	optional
class	box class	Augment default CSS classes of the whole message box. Particularly useful if your template uses TemplateStyles.	empty	optional
lang	language	Set the language of the text – it's important for right-to-left languages: their image is on the right and imageright is on the left. It helps assistive software (e.g. screen readers) even in left-to-right languages.	empty	optional
width	box width	Set the width of the box (avoid using it, 80% for example is too large as it leaves only 10% of the page content width for the left/right margins where there may be floating elements generally large of about 250px: if this occurs the Mbox will be displayed at a much lower position on the page, as if there was a "clear:both", so Mbox may not be immediately visible without scrolling down the page with a huge blank space in the middle and all the rest of the page after the Mbox will be also invisible without scrolling). Instead, use the "margin" parameter to set horizontal margins. To avoid the centering, and/or the thick left border, modify e.g. “style=margin-left:0;border-left:2px solid #F4C430”	auto	optional
margin	horizontal margin	Set the horizontal margin of the box (by default it is "auto" if a legacy width is specified, otherwise it is "10%").	10%	optional

Additional information

The template is intended to be used in the following namespaces: all namespaces

The template is intended to be used by the following user groups: all users

See also

• {{NoteBox}}

Localization

This template is localized using Module:TNT. These translations are stored in Data:I18n/Message box.tab.

Note

The icon displayed in the message box is clickable and drives to Commons (to see its attributions), but only when the message box is displayed in a "Template:" page (including their talk pages). When the template is displayed in a page belonging to all other namespaces, no link is generated, only the icon is visible directly.

Examples

All possible values for parameter "type"

type=(empty) → default (synonym to notice)

type=notice → for informative messages only

type=message → for informative messages only

type=query → for minor issues

type=style → for cleanup (synonym to query, only different icon)

type=issue → for larger issues

type=content → for content issues (synonym to issue)

type=serious → for serious notices

type=delete → for deletion notices (synonym to serious)

type=stop → for stop and other caution notices, such as frequent issues (synonym to serious, only different icon)

type=speedy → for speedy deletion notices

type=warning → for urgent notices (synonym to speedy)

type=move → for move requests

type=protection → for protection notices (synonym to message, only different icon)

type=license → for licenses

type=legal → for legal disclaimers such as {{Trademark}}

type=honor → for honors such as featured image

type=growth → for other "good" notices

type=shit → for fun ... or for maintenance affairs :)

Examples with more parameters

type = (empty) and style = background:#DFF

type = query and image = [[File:Warning.svg|alt=Exclamation mark|30px|class=noviewer]]

type = query and image = [[File:OOjs UI icon alert-yellow.svg|alt=Exclamation mark|40px|class=noviewer]]

type = query and image = [[File:Lol exclam.png|alt=Exclamation mark|38px|class=noviewer]]

type = issue, image = [[File:Commons-emblem-hand-orange.svg|alt=Stop hand|45px|class=noviewer]] and style = background:#f7f7f7;

type = message, image = [[File:Pictogram voting info.svg|20px|class=noviewer]] and margin = 0em

type = growth, image = none and style = margin: 10px 0 10px 0 (top right bottom left)