Template:Infobox football biography/doc

{{Infobox football biography}} is intended to provide a quick overview of an association football player's or manager's details to enable a reader to extract the most oft-needed information without trawling through the article proper.

Usage

Note: all the field names ending in 1 should be repeated for each team, e.g. youthyears1 and youthclubs1 should be followed by youthyears2 and youthclubs2 and so on, as needed.
For current players {{Infobox football biography |embed = |name = |image = |image_size = |caption = |fullname = |birth_date = |birth_place = |height = |position = |currentclub = |clubnumber = |youthyears1 = |youthclubs1 = |years1 = |clubs1 = |caps1 = |goals1 = |nationalyears1 = |nationalteam1 = |nationalcaps1 = |nationalgoals1 = |medaltemplates = |club-update = |nationalteam-update = }}	For former players {{Infobox football biography |embed = |name = |image = |image_size = |caption = |fullname = |birth_date = |birth_place = |death_date = |death_place = |height = |position = |youthyears1 = |youthclubs1 = |years1 = |clubs1 = |caps1 = |goals1 = |totalcaps = |totalgoals = |nationalyears1 = |nationalteam1 = |nationalcaps1 = |nationalgoals1 = |medaltemplates = }}
For players who have become managers {{Infobox football biography |embed = |name = |image = |image_size = |caption = |fullname = |birth_date = |birth_place = |death_date = |death_place = |height = |position = |currentclub = |youthyears1 = |youthclubs1 = |years1 = |clubs1 = |caps1 = |goals1 = |totalcaps = |totalgoals = |nationalyears1 = |nationalteam1 = |nationalcaps1 = |nationalgoals1 = |medaltemplates = |manageryears1 = |managerclubs1 = }}	For managers who have not been players {{Infobox football biography |embed = |name = |image = |image_size = |caption = |fullname = |birth_date = |birth_place = |death_date = |death_place = |currentclub = |manageryears1 = |managerclubs1 = }}

Parameters

All parameters are optional.

{{{embed}}}

Enables the template to be embedded into another template, such as {{Infobox person}}.

{{{name}}}

The commonly used name of the player. If this is omitted, it will be inferred from the title of the article.

{{{fullname}}}

The player's complete name. Long names will wrap automatically to the width of the infobox, so there's no need to include explicit linebreaks.

{{{image}}}

A picture of the player, ideally on the pitch in the strip of his or her most recent team (or the team the player is most well-known for, in the case of retirees). Images should be given in the format Example.jpg, rather than [[File:Example.jpg]].

{{{image_size}}}

The image's size, given as a number.

{{{alt}}}

Alternative text for the image.

{{{caption}}}

A caption for the image.

{{{birth_date}}}

The player's date of birth. A template ({{Birth date}}, {{Birth date and age}}) should be used to add the date, but be sure to use the appropriate parameters to present the date in the same format as used in the text. The date should not be wikilinked.

{{{birth_place}}}

The location of the player's birth.

{{{height}}}

The player's height in the units most common within the country he or she plays with a conversion (e.g. by using {{convert}}).

{{{position}}}

The player's most common position or positions. If a player is known for playing in multiple roles then explain the point more fully within the article.

{{{currentclub}}}

The club for which the player currently plays, or is employed by. If the player now works in a non-playing role at the club, add this after the club in brackets. For retired players not employed by any club or federation, leave blank.

{{{clubnumber}}}

The shirt number of the player at his or her current club.

{{{youthclubs1}}}, {{{youthclubs2}}}... {{{youthclubs8}}}

A list of clubs that the player was a member of as a youth, one per attribute, earliest to latest.

{{{youthyears1}}}, {{{youthyears2}}}... {{{youthyears8}}}

A list of years that the player has been at each club as a youth, one per attribute, earliest to latest.

{{{years1}}}, {{{years2}}}... {{{years39}}}

A list of years that the player has been contracted at each professional club, one per attribute, earliest to latest.

{{{clubs1}}}, {{{clubs2}}}... {{{clubs39}}}

A list of professional clubs that the player has been contracted at, one per attribute, earliest to latest.

{{{caps1}}}, {{{caps2}}}... {{{caps39}}}

A list of appearances that the player has been awarded in league competition only for each professional club (note: Playoff matches are not counted as league matches by most statistical sources (e.g. Soccerbase and the Sky Sports (Rothmans) Football Yearbook, so they should not be included in this infobox), one per attribute, earliest to latest.

{{{totalcaps}}}

The total number of appearances the player has been awarded in league competition for all professional clubs.

{{{goals1}}}, {{{goals2}}}... {{{goals39}}}

A list of goals that the player has been awarded in league competition only for each professional club (note: Playoff matches are not counted as league matches by most statistical sources (e.g. Soccerbase and the Sky Sports (Rothmans) Football Yearbook, so they should not be included in this infobox), one per attribute, earliest to latest.

{{{totalgoals}}}

The total number of goals the player has scored in league competition for all professional clubs.

{{{nationalyears1}}}, {{{nationalyears2}}}... {{{nationalyears9}}}

A list of years that the player has played for each national team, one per attribute, earliest to latest.

{{{nationalteam1}}}, {{{nationalteam2}}}... {{{nationalteam9}}}

A list of international teams that the player has played for, including non-senior teams such as U21, one per attribute, earliest to latest.

{{{nationalcaps1}}}, {{{nationalcaps2}}}... {{{nationalcaps9}}}

A list of appearances that the player has been awarded in all competitions and friendlies for each national team, one per attribute, earliest to latest.

{{{nationalgoals1}}}, {{{nationalgoals2}}}... {{{nationalgoals9}}}

A list of goals that the player has been awarded in all competitions and friendlies for each national team, one per attribute, earliest to latest.

{{{managerclubs1}}}, {{{managerclubs2}}}... {{{managerclubs30}}}

A list of clubs that the person has served within the capacity of team manager. Please do not list positions other than team manager (such as assistant or coach positions, or director of football roles where this role is not considered managerial) unless that position is a significant part of the person's career; this will apply primarily to those with significant or perhaps primary experience in management. Clubs listed can be both local and national and should be restricted to those ordinarily considered notable in themselves.

{{{manageryears1}}}, {{{manageryears2}}}... {{{manageryears30}}}

A list of years to accompany the above clubs.

{{{medaltemplates}}}

Honours can be added here using the templates {{Medal}}.

{{{club-update}}} (previously {{{pcupdate}}})

A timestamp (~~~~~) at which the player's infobox club statistics are correct (not needed if the player has retired).

{{{nationalteam-update}}} (previously {{{ntupdate}}})

A timestamp (~~~~~) at which the player's infobox national team statistics are correct (not needed for former players).

Use as a child template

The embed parameter is used when embedding this infobox into another (see the Template:Infobox documentation which explains embedding and subboxes).

{{Infobox ABC
| name        = 
| <!-- etc. -->
| embedded    = <!-- or module= -->
  {{Infobox football biography
  | embed = yes
  | <!-- etc. -->
  }}
}}

Embedding other templates

The module parameter is used for embedding other templates into this infobox (see Wikipedia:Infobox modules).

{{Infobox football biography
| name = 
| <!-- etc. -->
| module = 
  {{Infobox ABC
  | embed = yes <!-- or child=yes / subbox=yes-->
  | <!-- etc. -->
  }}
}}

Examples

Independent

Tim Template

Tim Template in the Template Rangers
Personal information
Full name	Tim Tenerife Template
Date of birth	(1975-01-01) 1 January 1975
Place of birth	Template City, Templatia
Height
Playing position	Striker
Club information
Current team	Template City F.C.
Number	9
Youth career
1985–1987	Template Juniors
1987–1992	Template Youth
Senior career*
Years	Team	Apps†	(Gls)†
1992–1999	Template United F.C.	75	(26)
1999–2002	Template Rangers	32	(11)
2001	→ Example F.C. (loan)	15	(7)
2002–	Template City F.C.	113	(46)
National team‡
1991	Examplia U16	1	(0)
1996–1998	Templatia U21	8	(2)
1999–	Templatia	46	(13)
Honours Template City F.C. Winner Template League 2003 Runner-up Template Cup 2004 Templatia Third place FIFA Template Cup 2001
* Senior club appearances and goals counted for the domestic league only and correct as of 14:56, 6 October 2014 (UTC). † Appearances (Goals). ‡ National team caps and goals correct as of 14:56, 6 October 2014 (UTC)

{{Infobox football biography
|name           = Tim Template
|image          = Nizar-Khalfan.jpg
|alt            = Photo of a player in blue football kit, hair braided.
|caption        = Tim Template in the Template Rangers
|fullname       = Tim Tenerife Template
|birth_date     = {{birth date and age|1975|1|1|df=y}}
|birth_place    = Template City, Templatia
|height         = {{height|m=1.75}}
|position       = [[Forward (association football)|Striker]]
|currentclub    = Template City F.C.
|clubnumber     = 9
|youthyears1    = 1985–1987
|youthclubs1    = Template Juniors
|youthyears2    = 1987–1992
|youthclubs2    = Template Youth
|years1         = 1992–1999
|clubs1         = Template United F.C.
|caps1          = 75
|goals1         = 26
|years2         = 1999–2002
|clubs2         = Template Rangers
|caps2          = 32
|goals2         = 11
|years3         = 2001
|clubs3         = → Example F.C. (loan)
|caps3          = 15
|goals3         = 7
|years4         = 2002–
|clubs4         = Template City F.C.
|caps4          = 113
|goals4         = 46
|nationalyears1 = 1991
|nationalteam1  = Examplia U16
|nationalcaps1  = 1
|nationalgoals1 = 0
|nationalyears2 = 1996–1998
|nationalteam2  = Templatia U21
|nationalcaps2  = 8
|nationalgoals2 = 2
|nationalyears3 = 1999–
|nationalteam3  = Templatia
|nationalcaps3  = 46
|nationalgoals3 = 13
|medaltemplates =
{{medal|Team|Template City F.C.}}
{{medal|W|Template League| 2003}}
{{medal|RU|Template Cup| 2004}}
{{medal|Team|Templatia}}
{{medal|3rd|FIFA Template Cup| 2001}}
|club-update     = ~~~~~
|nationalteam-update = ~~~~~
}}

Embedded

{{Infobox person
|name           = Tim Template
|image          = Nizar-Khalfan.jpg
|alt            = Photo of a player in blue football kit, hair braided.
|caption        = Tim Template in the Template Rangers
|birth_name     = Tim Tenerife Template
|birth_date     = {{birth date and age|1975|1|1|df=y}}
|birth_place    = Template City, Templatia
|height         = {{height|m=1.75}}
|module         =
{{Infobox football biography
|embed          = yes
|position       = [[Forward (association football)|Striker]]
|currentclub    = Template City F.C.
|clubnumber     = 9
|youthyears1    = 1985–1987
|youthclubs1    = Template Juniors
|youthyears2    = 1987–1992
|youthclubs2    = Template Youth
|years1         = 1992–1999
|clubs1         = Template United F.C.
|caps1          = 75
|goals1         = 26
|years2         = 1999–2002
|clubs2         = Template Rangers
|caps2          = 32
|goals2         = 11
|years3         = 2001
|clubs3         = → Example F.C. (loan)
|caps3          = 15
|goals3         = 7
|years4         = 2002–
|clubs4         = Template City F.C.
|caps4          = 113
|goals4         = 46
|nationalyears1 = 1991
|nationalteam1  = Examplia U16
|nationalcaps1  = 1
|nationalgoals1 = 0
|nationalyears2 = 1996–1998
|nationalteam2  = Templatia U21
|nationalcaps2  = 8
|nationalgoals2 = 2
|nationalyears3 = 1999–
|nationalteam3  = Templatia
|nationalcaps3  = 46
|nationalgoals3 = 13
|medaltemplates =
{{medal|Team|Template City F.C.}}
{{medal|W|Template League| 2003}}
{{medal|RU|Template Cup| 2004}}
{{medal|Team|Templatia}}
{{medal|3rd|FIFA Template Cup| 2001}}
|club-update     = ~~~~~
|nationalteam-update = ~~~~~
}}
}}

Style guide

Try to always consider that an infobox exists to support an article and provide a quick synopsis of important facts. This becomes vital when considering that the amount of space available within an infobox is significantly less than that available outside of it.

As per the manual of style entry on linking, years and dates should not be linked as they do not provide much benefit to the user.

Do not add flag icons to the birth_place, death_place, club, national team or other fields. See: Wikipedia:Manual of Style (flags).

As per the manual of style the player's height should be in the units most common in the country in which he or she plays. Units should be abbreviated in the infobox and spelt out in the article text. Ideally, measurements should be presented using the {{convert}} template, which automatically converts units between formats and handles the presentation of units. In this case, use the |abbr=on flag to ensure that units are presented in their short forms. {{height}} is a similar template designed for infoboxes, which presents units in short form by default.

Using {{convert}}:

• {{convert|5|ft|10|in|abbr=on}} produces
• {{convert|1.78|m|abbr=on}} produces

and using {{height}}:

• {{height|ft=5|in=10}} produces
• {{height|m=1.78}} produces

Microformats

The HTML markup produced by this template includes an hCard microformat, which makes the person's details 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 or database. For more information about the use of microformats on Wikipedia, please see the microformat project.

Sub-templates

Date-of-birth ("bday") information will only be included in the microformat if {{birth date}}, or {{birth date and age}} are used in the infobox. (Do not use these if the date is before 1583).

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

Please do not remove instances of these sub-templates.

Classes

hCard uses HTML classes including:

• adr
• agent
• bday
• birthplace
• category
• country-name
• deathdate
• deathplace
• extended-address
• family-name
• fn (required)
• given-name
• honorific-prefix
• honorific-suffix
• label
• locality
• n
• nickname
• note
• org
• role
• url
• vcard

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

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly error report for this template.

TemplateData for Infobox football biography

This infobox template provides a quick overview of an association football player's or manager's details to enable a reader to extract the most oft-needed information without trawling through the article proper.

Template parameters

Parameter		Description	Type	Status
Name	name	The commonly used name of the player. If this is omitted, it will be inferred from the title of the article.	String	optional
Full name	fullname	The player's complete name.	String	optional
Picture	image	A picture of the player, ideally on the pitch in the strip of his or her most recent team (or the team the player is most well-known for, in the case of retirees). Use the format Example.jpg, rather than [[File:Example.jpg]].	Page name	optional
Picture size	image_size	The picture's size, given as a number.	Number	optional
Picture alt text	alt	Alt text for the picture.	String	optional
Picture caption	caption	A caption for the picture.	String	optional
Birth date	birth_date	The player's date of birth. A template ({{Birth date}}, {{Birth date and age}}) should be used to add the date, but be sure to use the appropriate parameters to present the date in the same format as used in the text. The date should not be wikilinked.	Number	optional
Birth place	birth_place	The location of the player's birth.	String	optional
Height	height	The player's height in the units most common within the country he or she plays. The {{height}} template should be used for automatic formatting.	Number	optional
Position	position	The player's most common position or positions. If a player is known for playing in multiple roles then explain the point more fully within the article.	String	optional
Current club	currentclub	The club for which the player currently plays, or is employed by. If the player now works in a non-playing role at the club, add this after the club in brackets. For retired players not employed by any club or federation, leave blank.	String	optional
Number	clubnumber	The shirt number of the player at their current club.	Number	optional
Youth club 1	youthclubs1	The first club that the player was a member of as a youth. Up to 8 clubs can be added using the parameter names "youthclubs2", "youthclubs3", etc.	String	optional
Youth club 2	youthclubs2	The second club that the player was a member of as a youth.	String	optional
Youth club 1 years	youthyears1	The years that the player was at their first youth club. Up to 8 clubs can be added using the parameter names "youthyears2", "youthyears3", etc.	Number	optional
Youth club 2 years	youthyears2	The years that the player was at their second youth club.	Number	optional
Club 1	clubs1	The first (senior) club that the player has been contracted at. Up to 39 clubs can be added using the parameter names "clubs2", "clubs3", etc.	String	optional
Club 2	clubs2	The second club that the player has been contracted at.	String	optional
Club 1 years	years1	The years that the player was at their first club. Up to 39 years can be added using the parameter names "years2", "years3", etc.	Number	optional
Club 2 years	years2	The years that the player was at their second club.	Number	optional
Club 1 appearances	caps1	The number of appearances that the player has been awarded in league competition for the first club. Playoff matches should not be included. Up to 39 caps can be added using the parameter names "caps2", "caps3", etc.	Number	optional
Club 2 appearances	caps2	The number of appearances that the player has been awarded in league competition for the second club.	Number	optional
Club appearances total	totalcaps	The total number of appearances the player has been awarded in league competition for all non-youth clubs.	Number	optional
Club 1 goals	goals1	The number of goals that the player has been awarded in league competition for the first club. Playoff matches should not be included. Up to 39 can be added using the parameter names "goals2", "goals3", etc.	Number	optional
Club 2 goals	goals2	The number of goals that the player has been awarded in league competition for the second club.	Number	optional
Club goals total	totalgoals	The total number of goals the player has scored in league competition for all non-youth clubs.	Number	optional
National team 1	nationalteam1	The first national team that the player has played for (including non-senior teams such as U21). Up to 9 teams can be added using the parameter names "nationalteam2", "nationalteam3", etc.	String	optional
National team 2	nationalteam2	The second national team that the player has played for.	String	optional
National team 1 years	nationalyears1	The years that the player has played for the first national team. Up to 9 years can be added using the parameter names "nationalyears2", "nationalyears3", etc.	Number	optional
National team 2 years	nationalyears2	The years that the player has played for the second national team.	Number	optional
National team 1 appearances	nationalcaps1	The number of appearances that the player has been awarded in all competitions and friendlies for the first national team. Up to 9 numbers can be added using the parameter names "nationalcaps2", "nationalcaps3", etc.	Number	optional
National team 2 appearances	nationalcaps2	The number of appearances that the player has been awarded in all competitions and friendlies for the second national team.	Number	optional
National team 1 goals	nationalgoals1	The number of goals that the player has been awarded in all competitions and friendlies for the first national team. Up to 9 numbers can be added using the parameter names "nationalgoals2", "nationalgoals3", etc.	Number	optional
National team 2 goals	nationalgoals2	The number of goals that the player has been awarded in all competitions and friendlies for the second national team.	Number	optional
Manager club 1	managerclubs1	The first club that the person has served within the capacity of team manager. Please do not list positions other than team manager (such as assistant or coach positions, or director of football roles where this role is not considered managerial) unless that position is a significant part of the person's career; this will apply primarily to those with significant or perhaps primary experience in management. Clubs listed can be both local and national and should be restricted to those ordinarily considered notable in themselves.	String	optional
Manager club 2	managerclubs2	The second club that the person has served within the capacity of team manager. Up to 30 can be added using the parameter names "managerclubs3", "managerclubs4", etc.	String	optional
Manager club 1 years	manageryears1	The years that the person has served with the first club in the capacity of team manager.	Number	optional
Manager club 2 years	manageryears2	The years that the person has served with the second club in the capacity of team manager. Up to 30 can be added using the parameter names "manageryears3", "manageryears4", etc.	Number	optional
Medal templates	medaltemplates	Honors can be added here using {{Medal}} templates.	String	optional
Professional club update timestamp	club-update	A timestamp (~~~~~) at which the player's professional club statistics are correct (not needed if the player has retired).	String	optional
National team update timestamp	nationalteam-update	A timestamp (~~~~~) at which the player's national team statistics are correct (not needed if the player has retired).	String	optional
Date of death	death_date	Use exact date if known, but otherwise as close an approximation as possible. Example: April 27, 1992	String	optional
Place of death	death_place	Example: Washington, DC, USA	String	optional

See also

Hidden tracking/maintenance categories

• Category:Infobox football biography image param needs updating
• Category:Football biography using missing parameters
• Category:Football biography using deprecated parameters
• Category:Football biography using old style parameters