RandomUser34: 1 revision imported

2026-02-20T01:55:49Z

1 revision imported

← Older revision		Revision as of 01:55, 20 February 2026
(No difference)

wp>Jonesey95: /* See also */ header

2023-08-10T01:26:15Z

See also: header

New page

{{Documentation subpage}}

{{High-use}}
{{tsh|ubxt}}

This template can be used to organize userboxes (or other user-page content) into a single column grouping.

Please do '''not''' use this in articles: for historic reasons this template uses different rules for floating alongside other templates and this will lead to unpredictable results. If you need to stack objects in an article for some reason, use {{tl|stack}}. This template will add pages in the [[WP:NS0|main namespace]] to [[:Category:Articles incorrectly using userbox templates]].

== Usage ==

<syntaxhighlight lang="wikitext">
{{Userboxtop
| toptext =
| toptextstyle =
| align =
| left =
| backgroundcolor =
| bordercolor =
| extra-css =
| textcolor =
}}

{{userboxname1}}
{{userboxname2}}
{{userboxname3}}
{{userboxname4}}
{{...etc}}}

{{Userboxbottom}}
</syntaxhighlight>

Note that {{tlc|Userboxbottom}} must be separated from the last userbox by a newline. In the absence of a newline, other text on the page may appear inside the confines of the userbox area.

== Parameters ==

All parameters are optional.

{| class="wikitable"
! Parameter
! Description
|-
| <code>toptext</code>
| (or the first positional parameter) Overrides the default header "[[Wikipedia:Userboxes|Userboxes]]". Can include wiki-markup.
|-
| <code>toptextstyle</code>
| Additional [[Cascading Style Sheets|CSS]] code for the <code>toptext</code>.
|-
| <code>align</code>
| (or the second positional parameter) <code>left</code> or <code>center</code> or <code>right</code> (default)
|-
| <code>left</code>
| Left margin in CSS's [[em (typography)|ems]]. Defaults to 1.
|-
| <code>backgroundcolor</code>
| Any [[Web colors|web color]] (name or <code>#XXXXXX</code> hex format). Defaults to <code>#FFFFFF</code>.
|-
| <code>bordercolor</code>
| Any [[Web colors|web color]] (name or <code>#XXXXXX</code> hex format). Defaults to <code>#99B3FF</code>.
|-
| <code>extra-css</code>
| Additional [[Cascading Style Sheets|CSS]] code for the box itself.
|-
| <code>textcolor</code>
| Any [[Web colors|web color]] (name or <code>#XXXXXX</code> hex format). Defaults to <code>#000000</code>.
|}

You may also insert breaks by using {{tl|userboxbreak}}. See that template for details.

== Hiding userboxes ==

You can hide userboxes which use this (as well as a few other) forms of template-based userbox organization. Simply go to [[Special:Mypage/skin.css]], which redirects to your current [[WP:SKIN|skin]]'s CSS file, and add the following:

<syntaxhighlight lang="css">
table.userboxes { display: none; }
</syntaxhighlight>

== Redirects ==
* {{tl|BoxTop}}
* {{tl|Boxboxtop}}
* {{tl|Boxtop}}
* {{tl|User box top}}
* {{tl|Userbox top}}

== See also ==
* {{tl|Userboxbreak}}
* {{tl|Userboxbottom}}
* {{tl|Userboxside}}
* {{tl|Userboxgroup}}

<includeonly>{{Sandbox other||

[[Category:User namespace templates]]
[[Category:Userbox arrangement templates]]
[[Category:Templates with partial table wikitext]]

}}</includeonly>

==TemplateData==
{{TemplateData header}}
<templatedata>
{
"params": {
"left": {
"label": "Left margin size",
"description": "Left margin size (in CSS ems). Defaults to 1",
"example": "1",
"type": "number",
"default": "1"
},
"bordercolor": {
"label": "Border colour",
"description": "Colour for the userbox border. Any web color (name or #XXXXXX hex format). Defaults to #99B3FF.",
"example": "#99B3FF",
"type": "line",
"suggestedvalues": [
"#99B3FF",
"black",
"grey",
"#4A412A"
],
"default": "#99B3FF"
},
"backgroundcolor": {
"label": "Background colour",
"description": "Background colour for this userbox. Any web color (name or #XXXXXX hex format). Defaults to #FFFFFF.",
"example": "#FFFFFF",
"type": "line",
"suggestedvalues": [
"#FFFFFF",
"white",
"lightgrey"
],
"default": "#FFFFFF"
},
"textcolor": {
"label": "Text colour",
"description": "Default colour for text within this userbox. Any web color (name or #XXXXXX hex format). Defaults to #000000.",
"example": "#000000",
"type": "line",
"suggestedvalues": [
"black",
"#000000",
"crimson",
"darkblue",
"green"
],
"default": "#000000"
},
"align": {
"aliases": [
"2"
],
"label": "Alignment",
"description": "Whether you want your userbox to be left-aligned or right-aligned. Value must be 'left' or 'right'.",
"example": "right",
"type": "line",
"suggestedvalues": [
"left",
"right"
],
"default": "right",
"suggested": true
},
"extra-css": {
"label": "Extra CSS",
"description": "Additional CSS code for the box itself.",
"type": "string"
},
"toptextstyle": {
"label": "Header style (toptextstyle)",
"description": "Additional CSS code for the header (toptext).",
"type": "string"
},
"toptext": {
"aliases": [
"1"
],
"label": "Header (toptext)",
"description": "Overrides the default header \"Userboxes\". Can include wiki-markup",
"example": "About me",
"type": "line",
"suggestedvalues": [
"About me",
"Information",
"Userboxes"
],
"default": "Userboxes",
"suggested": true
}
},
"description": "This template can be used to organize userboxes (or other user-page content) into a single column grouping. Please do *not* use this in articles. Please see https://en.wikipedia.org/wiki/Template:Userboxtop/doc for full documentation.",
"paramOrder": [
"toptext",
"align",
"toptextstyle",
"textcolor",
"left",
"bordercolor",
"backgroundcolor",
"extra-css"
],
"format": "block"
}
</templatedata>

Template:Userboxtop/doc - Revision history

RandomUser34: 1 revision imported

wp>Jonesey95: /* See also */ header