Wikipedia:Userboxes

The standard syntax for adding a userbox to your user page (also known as transclusion) is: {{user name_of_box}}.

If you do not have any userboxes on your user page yet, you want to begin using them, and you want to add them down the right side of your user page starting at the top, then edit your user page and, at or near the top of the source for your user page, add {{Userboxtop |}}, add the transclusion(s) for the userbox(es) you wish to include, and add {{userboxbottom}} just after the last userbox transclusion. Please see the #Grouping_userboxes section for other ways of grouping and placing userboxes.

You may decide to substitute the template code onto your user page using the syntax {{subst:user name_of_box}}. The use of "subst:" will ensure that the template is always displayed in its form when you add it to your user page (i.e. it will not reflect subsequent edits to the template). This method will lead to large amounts of code on your user page.

The namespace you place your userbox in matters. Userboxes may only be created or displayed in the User, Project (Wikipedia), or Template namespaces.

So which prefix is best for your userbox: User:, Wikipedia:, or Template:?

Since content in User:space represents individual editors more than the community, they are traditionally given more leeway than in other namespaces. Thus, userboxes in User:space may not be as directly collaborative in nature as those in Template:or Wikipedia:namespaces, which are expected to adhere more tightly with certain policies and guidelines, especially Neutral point of view and What Wikipedia is not. This should also be considered before moving a userbox from userspace to any other namespace.

User:

To host a userbox in the user namespace, create a subpage of your own user page or User:UBX.

Wikipedia:

Userboxes in the project namespace are generally for WikiProject or task force usage. Simply create it as a subpage of the WikiProject (e.g. Wikipedia:WikiProject Board and table games/Userbox).

Template:

In the template namespace, userbox names must begin with "User " (e.g. Template:User Brazil or Template:User en)

If you are uncertain if your userbox is in the correct namespace, consider presenting the userbox at the New Userboxes talk page for community comment.

A userbox can be coded to autocategorise any user pages which transclude the userbox into one or more user categories. However, do not use autocategorisation without good reason.

• Most userboxes refer to a single isolated characteristic of the user; unless the characteristic directly relates to the user's ability or willingness to collaborate on certain areas of or topics within Wikipedia, a user category should not exist for it and the userbox should not be used for categorisation.
• Users of the userbox can be located using the Special:WhatLinksHere tool from the userbox template. Networking between editors with similar interests or views is best done using a projectspace essay with a signup section for editors interested in networking.
• If there is a good reason for the user category, first create the category pages and include a description that explains its purpose and scope.
• User categories must be sub-categories of Category:Wikipedians.
• Names and descriptions of user categories are subject to the same rules and restrictions as userbox content.

• All userboxes are governed by the civility policy.
  • Userboxes must not include incivility or personal attacks.
  • Userboxes must not be inflammatory or substantially divisive.
• Wikipedia is not an appropriate place for:
  • Propaganda, advocacy, or recruitment of any kind (commercial, political, religious, or otherwise)
  • Opinion pieces, particularly on current affairs or politics
  • Self-promotion or advertising

Simply: If content is not appropriate on other parts of a user page, it is not appropriate within userboxes.

Wikimedia Commons has a large range of icons for use within boxes. However, if you select an image from somewhere else, make certain the image has a free license. Templates (which includes userboxes and topicons) on user pages may not contain any copyrighted content not under free license; so, for example, "fair use" images are explicitly forbidden. This is interpreted strictly and without exception. See Wikipedia's fair use policy guidelines for more details.

Please be mindful of the colour contrast guidelines at WP:COLOUR – low-contrast colours present accessibility barriers to people with colour-blindness or other visual disabilities.

The following section is not to be considered all-inclusive. As such, other word combinations (both appropriate and inappropriate) are obviously possible.

Typical userbox content:

• This user <verb phrase> <noun phrase>.
• This user <verb phrase> <noun phrase> <prepositional phrase>.

Typical verbs:

• verbs of action: contributes (to), drives, eats, edits, plays, uses, watches
• verbs of comprehension: reads, speaks, understands
• verbs of preference: enjoys, likes, loves

Additional examples, using the linking verb is:

• This user is <noun phrase>.
• This user is a fan of <noun phrase>.
• This user is a member of <noun phrase>.
• This user is interested in <noun phrase>.

Another option is to allow changing the verb phrase using a template parameter. This is especially useful in location userboxes:

• This user {{{1|lives inTɛmplet:))) <location>.

To avoid the awkward third-person phrasing ("This user"), you can use "{{#titleparts: {{PAGENAME}} | 1 | 1 }}" (without the quotes) to insert the name of the user that includes it on their page (e.g. "{{#titleparts: {{PAGENAME}} | 1 | 1 }} uses second-person phrasing" produces "Userboxes uses second-person phrasing").

There are a number of box types to select from when deciding to make a userbox. The most commonly used design is the "Standard box". It has one square shaped area on the left ("id") and a rectangular area on the right ("info").

For ease of use, userboxes are typically made using maker-templates that have a number of parameters.

The id and info boxes can include text, links, and images using the usual Wikipedia syntax. Generally, the info box will contain a sentence with a link or two, while the id box will contain a few letters or a 43px image.

Tɛmplet:Userboxtop

 Tɛmplet:User WikiProject Userboxes
 Ŋun su:UBX/Rome
 Ŋun su:Nihiltres/Userboxes/Friendly

Tɛmplet:Userboxbottom

As with the Babel box, there is a box to group userboxes together. Just make a list of userboxes with {{Userboxtop|box-name}} at the top, followed by your list of userboxes, and {{Userboxbottom}} at the bottom. For example, the box to the right is created using the following list:

{{Userboxtop}}
{{User WikiProject Userboxes}}
{{User:UBX/Rome}}
{{User:Nihiltres/Userboxes/Friendly}}
{{Userboxbottom}}

Using collapsible tables

[mali mi di yibu sheena n-niŋ]

Tɛmplet:Userboxtop

My yellow userboxes
Sample userbox #1. Sample userbox #2. Sample userbox #3.

My purple userboxes
Sample userbox #4. Sample userbox #5. Sample userbox #6.

Tɛmplet:Userboxbottom

If you wish to group your userboxes into expandable lists in the {{Userboxtop}} template, one way of doing this is by using collapsible tables with certain classes. Wikipedia's Mediawiki configuration attempts to make this happen through a combination of ECMAScript and CSS. This method is accessible to users with ECMAScript (jScript/JavaScript) disabled, and should work in most modern browsers (it is the method used by {{Navbox}}).

Using the codes in Help:Collapsing works much better and simpler using normal wiki table markup!

 {{Userboxtop|Example 2}}
 <table class="collapsible collapsed" style="width: 100%; background: transparent; color: inherit;">
   <tr><th style="background:lavender;">(Caption)</th></tr>
   <tr><td>
     (Place your userboxes here...)
   </td></tr>
 </table>
 {{Userboxbottom}}

Include 'collapsed' if you want the box to start closed, omit it if you want the box to start open. You can also use multiple tables to get separate collapsible parts like in the example to the right.

You can now use {{Userboxgroup}} to create this kind of box.

The Babel grouping system can also be used, e.g. {{Babel|sv|no-4|in Rome}}, which generates:

Tɛmplet:Babel

However, it only works for user boxes with the "User" prefix, which must then be dropped for the arguments.

Also, boxes that need arguments of their own (such as {{User:UBX/Monty Python}} or {{User Translator}}) are difficult to use with the Babel system. They can be used by including parameters with magic word replacing the vertical bars and equals signs, e.g. {{Babel|fr-5|ja-2|Translator|fr|project{{=}}no}} (result below), but this behavior is not officially supported by the template, and may not work in all contexts and break at some point in the future.

Tɛmplet:Babel

Another alternative would be to table your userboxes:

{| style="margin: 1em auto;"
|+ example 6
|-
| {{User:AusTerrapin/Box:Jazz Fusion}} {{User_USAFo5}}
|-
| {{User helper}} {{User:The Raven's Apprentice/Userboxes/User Warm}}
|}

would produce the following:

To center one userbox use this coding:

{| style="margin: 1em auto;"
|+ example 7
|-
| {{User:Saoshyant/Userboxes/User oops}}
|}

which produces: