Usage

The {{football squad player}} and related templates are used to display the players on an association football (soccer) squad (team, club), in a consistent format:

{{football squad start |team=[[Real Madrid F.C.|Real Madrid]] |hidenote=y}}
{{football squad player |num=9  |pos=FW |name=[[Aleksandar Đurić]] |note=captain}}
{{football squad player |num=1  |pos=GK |name=[[Iker Casillas]]}}
{{football squad player |num=25 |pos=G⁠K |name=[[Joe Hart]]}}
...
{{football squad mid |team= }}
{{football squad player |num=13 |pos=MF |name=[[Park Ji-sung]]}}
{{football squad player |num=3  |pos=DF |name=[[Gerard Pique]]}}
{{football squad player |num=10 |pos=F⁠W |name=[[Robin Van Persie]]}}
...
{{football squad end}}

Real Madrid No. Pos. Nation Player — FW   Aleksandar Đurić — GK   Iker Casillas — G⁠K   Joe Hart — ...   {{{name}}}

No. Pos. Nation Player — MF   Park Ji-sung — DF   Gerard Pique — F⁠W   Robin Van Persie — ...   {{{name}}}

In this case, the captain is listed first, followed by other members by alphabetical order of family name; in other cases, you might prefer to list them by shirt number, position or some other criteria.

The templates can technically be used for other sports, but note that the pre-set values of the |pos= parameter automatically link to association football articles by default.

Syntax

Most such tables are split into two vertical columns. For these, you can use the {{football squad start}}, {{football squad mid}}, and {{football squad end}} templates for layout, and then use the {{football squad player}} template repeatedly within that layout:

{{football squad start}}
<!-- For help using the below template, please see [[Template talk:Football squad player]] -->
{{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}}
{{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}}
...
{{football squad mid}}
{{football squad player |name=Player Name |num=shirt number |nat=team nationality (if not already clear in context) |pos=position or role played |note=optional parenthetical note}}
...
{{football squad end}}

For a single-column layout, you can omit {{football squad mid}}.

Flag icons

Whether the WP:MOSICON guideline's rule against the use of flag icons to indicate a player's birth place or individual legal citizenship, rather than sporting nationality as a team member, should be changed is the subject of an ongoing discussion as of June 2014^[update].

Parameters

The parameters of {{football squad start}} and {{football squad mid}} are:

• team to specific the team name (which may be wikilinked)
• hidenote=y to suppress display of the above-table note about flags, e.g. when there are not flags in the table, or several such tables are being used in series and the first already has the note.
• nohead to rename or suppress the "No." heading (e.g. to replace it with " " to blank it out when it isn't used
• nathead=Nat. to have a nationality heading appear (it is suppressed by default). Another value can be given, e.g. |nathead=State.
• poshead to suppress display of the "Position" heading with " ", when this column isn't being used; or use it to change "Position" to "Pos.", "Role", etc.

The parameters of {{football squad player}} are:

• name (or 1) The player's name, the only required parameter. If the value is unassigned as of this writing, you can simply put "[unassigned]", "[vacant]" or the like, to indicate a vacant position. Do not add anything to the name here (citations go in the |ref= parameter, and notes go in the |note= parameter.
• num (or no): The shirt number of the player, if they have one. If the player's number is not known, or unassigned, then you can use the – character instead, or simply omit it. If omitted for all entries, use the |nohead=  parameter in {{football squad start}} and {{football squad mid}} to suppress the "No." heading.
• nat: The player's sporting nationality (the country that the player represents in international football), which may have nothing to do with citizenship or birth place. Use the name of the country, or its 3-letter IOC country code, rather than an adjective (e.g. "Spain" instead of "Spanish"). If used, also use the |nathead=Nat. parameter in {{football squad start}} and {{football squad mid}} to enable the "Nat." heading above the icons.
• pos: The position in which the player plays. If omitted for all entries, use the |poshead=  parameter in {{football squad start}} and {{football squad mid}} to suppress the "Pos." heading. You can use any of the four options below for the position, and they'll be linked automatically:
  1. GK for goalkeeper
  2. DF for defender (including sweeper, centre-, full- and wing-back
  3. MF for midfielder
  4. FW for forward or striker (incl. winger and second striker)
  5. some other value; one example would be using G⁠K to replace second and subsequent occurrences of "GK" with a "G" then a zero-width non-breaking space in it then a "K", so that the template does not redundantly link it; another case could be to use [[Association football positions#Attacking midfield|AM]] if there is some reason to be more specific, or a similar link to another position in another sport if the template is being used for non-soccer purposes.
• ref: A reference footnote, which appears immediately after the player name. It must be in the form |ref=<ref ...>...</ref>. This keeps the reference citation code from being confused with part of the player's name in metadata.
• note (or other): This is an optional parameter. You can add any related info to this parameter, like specifying captain, vice-captain, whether the player is on loan, etc. It will show additional info in the parentheses (round brackets) after the player name.

Examples

For example, the following code:

{{Football squad start}}
{{football squad player | no=1  | nat=Spain      | pos=GK | name=[[Iker Casillas]]}}
{{football squad player | no=3  | nat=Spain      | pos=DF | name=[[Gerard Pique]]}}
{{football squad player | no=9  | nat=Singapore  | pos=FW | name=[[Aleksandar Đurić]] | other=team captain}}
{{football squad mid}}
{{football squad player | no=10 | nat=Netherlands| pos=FW | name=[[Robin Van Persie]]}}
{{football squad player | no=13 | nat=South Korea| pos=MF | name=[[Park Ji-sung]]}}
{{football squad player | no=25 | nat=England    | pos=GK | name=[[Joe Hart]]}}
{{football squad end}}

Produces this table:

Note: Flags indicate national team as defined under FIFA eligibility rules. Players may hold more than one non-FIFA nationality.

No. Pos. Nation Player 1 GK  ESP Iker Casillas 3 DF  ESP Gerard Pique 9 FW  SGP Aleksandar Đurić (team captain)

No. Pos. Nation Player 10 FW  NED Robin Van Persie 13 MF  KOR Park Ji-sung 25 GK  ENG Joe Hart

Shortented template names

In order to make easier the work of writing new squads, some alternative, shorter, names has been designed. So, you may now use {{Fs start}}, {{Fs mid}}, {{Fs player}}, {{Fs end}} and {{Fs blank column}} as alternative templates, using the same equivalent syntax of the other ones.

Microformat

The HTML markup produced by this template includes an hCard microformat, which makes the person's name parsable by computers, either acting automatically to catalogue articles across Wikipedia or via a browser tool operated by a reader, to (for example) add the subject to an address book. For more information about the use of microformats on Wikipedia, please see the microformat project.

To include a URL, use {{URL}}.

Classes

The hCard in this template uses at least some of these HTML classes:

Please do not rename or remove these classes nor collapse nested elements which use them.