Template:Infobox athlete/doc

Infobox athlete is WikiPartner's standard infobox for individual athletes and sportspeople, including footballers, cricketers, basketball players, tennis players, runners, swimmers, boxers, martial artists, racing drivers, and other notable competitors.

Use this template for individual people. Sports teams and clubs should use their own organization or sports-team infobox.

All parameters are optional. Add only information supported by reliable sources. Empty fields are automatically hidden.

Adding this template to an article also generates WikiPartner Person structured data with the person's sporting profession represented as an occupation. Team memberships, sports skills, physical measurements, education, awards, official website, and image may also be represented when suitable data is supplied.

Short usage

Use this version for most athlete articles.

{{Infobox athlete
| name =
| image =
| image_alt =
| caption =
| birth_date =
| birth_place =
| nationality =
| occupation =
| sport =
| position =
| current_team =
| national_team =
| height =
| awards =
| website =
}}

Full usage

Use this version when more information is available. Remove parameters that are not needed.

{{Infobox athlete
| name =
| native_name =
| other_name =
| birth_name =

| image =
| image_alt =
| caption =

| birth_date =
| birth_date_iso =
| birth_place =

| death_date =
| death_date_iso =
| death_place =

| nationality =
| citizenship =

| occupation =

| sport =
| discipline =
| events =
| position =
| handedness =
| playing_style =

| years_active =
| debut =
| retired =

| representing =

| current_team =
| club =
| national_team =
| former_teams =
| jersey_number =
| league =
| college_team =

| coach =

| height =
| height_cm =
| weight =
| weight_kg =

| career_record =
| highest_ranking =
| titles =
| medals =
| records =
| personal_bests =

| education =
| alma_mater =

| awards =

| spouse =
| partner =
| children =
| relatives =

| website =
}}

Examples

The examples below show both the wikitext entered by an editor and the finished WikiPartner infobox.

Images are not included so the documentation does not depend on particular uploaded photographs.

Footballer — Cristiano Ronaldo

Wikitext

{{Infobox athlete
| name = Cristiano Ronaldo
| birth_name = Cristiano Ronaldo dos Santos Aveiro
| birth_date = 5 February 1985
| birth_date_iso = 1985-02-05
| birth_place = Funchal, Portugal
| nationality = Portuguese
| occupation = Footballer
| sport = Association football
| position = Forward
| current_team = Al Nassr
| national_team = Portugal
| jersey_number = 7
| height = 1.89 m
| height_cm = 189
}}

Rendered infobox

Cristiano Ronaldo

Footballer

Birth name

Cristiano Ronaldo dos Santos Aveiro

Born

5 February 1985

Birth place

Funchal, Portugal

Nationality

Portuguese

Occupation

Footballer

Sport

Association football

Position

Forward

Current team

Al Nassr

National team

Portugal

Number

7

Height

1.89 m

Tennis player — Serena Williams

Wikitext

{{Infobox athlete
| name = Serena Williams
| birth_date = 26 September 1981
| birth_date_iso = 1981-09-26
| birth_place = Saginaw, Michigan, United States
| nationality = American
| occupation = Tennis player
| sport = Tennis
| handedness = Right-handed
| height = 1.75 m
| height_cm = 175
| highest_ranking = World No. 1
| titles = 23 Grand Slam singles titles
| medals = 4 Olympic gold medals
}}

Rendered infobox

Serena Williams

Tennis player

Born

26 September 1981

Birth place

Saginaw, Michigan, United States

Nationality

American

Occupation

Tennis player

Sport

Tennis

Handedness

Right-handed

Height

1.75 m

Highest ranking

World No. 1

Titles

23 Grand Slam singles titles

Medals

4 Olympic gold medals

Sprinter — Usain Bolt

Wikitext

{{Infobox athlete
| name = Usain Bolt
| birth_date = 21 August 1986
| birth_date_iso = 1986-08-21
| nationality = Jamaican
| occupation = Sprinter
| sport = Athletics
| discipline = Sprinting
| events = 100 metres; 200 metres; 4 × 100 metres relay
| medals = 8 Olympic gold medals
| records = 100 m world record; 200 m world record; 4 × 100 m relay world record
| personal_bests = 100 m – 9.58 s; 200 m – 19.19 s
}}

Rendered infobox

Usain Bolt

Sprinter

Born

21 August 1986

Nationality

Jamaican

Occupation

Sprinter

Sport

Athletics

Discipline

Sprinting

Events

100 metres; 200 metres; 4 × 100 metres relay

Medals

8 Olympic gold medals

Records

100 m world record; 200 m world record; 4 × 100 m relay world record

Personal bests

100 m – 9.58 s; 200 m – 19.19 s

Usage notes

Use name for the athlete's commonly recognized name.
Use native_name when the person's name in another writing system is useful.
Use other_name for another widely recognized name, nickname, or professional name.
other_names is accepted as an alias for other_name.
Use birth_name only when different from the commonly used name.
Use image for the portrait or suitable sports image filename only. Do not include File:....
Use image_alt for short alternative text describing the image.
alt is accepted as an alias for image_alt.
Use only properly licensed images.
Use birth_date and death_date for dates displayed to readers.
Use birth_date_iso and death_date_iso for structured data. Accepted formats are YYYY, YYYY-MM, and YYYY-MM-DD.
Use nationality and citizenship only when relevant and reliably documented.
occupation defaults to Athlete.
Prefer a more specific occupation where useful, such as Footballer, Cricketer, Tennis player, Basketball player, Boxer, Swimmer, or Sprinter.
Use sport for the primary sport.
Use discipline for a more specific sporting specialization such as sprinting, freestyle swimming, road cycling, or artistic gymnastics.
Use events for specific competitive events or categories. Separate multiple values with semicolons.
event is accepted as an alias for events.
Use position for a playing position such as Forward, Goalkeeper, Quarterback, Bowler, or Point guard.
Use handedness when playing hand is important, such as in tennis or racket sports.
Use playing_style only when a recognized playing style is useful and reliably sourced.
Use years_active for the professional or international career period.
Use debut for an important professional, senior, or international debut.
Use retired only after retirement has actually been announced or clearly established.
Use representing when the country or sporting delegation represented in competition is useful.
Use current_team for the athlete's current professional or club team.
team is accepted as an alias for current_team.
Use club when a sports or training club is useful and distinct from the current team field.
Use national_team for a national team currently represented by the athlete.
Use former_teams only for important former teams. Do not turn the infobox into a complete career-history table.
Use jersey_number only when a current number is relevant to the sport.
Jersey numbers can change after transfers or squad changes, so keep this field current.
Use league only when the athlete participates in a clearly identified professional league.
Use college_team when college or university sport is an important part of the person's career.
Use coach for a current or major coach when reliably documented.
Coaches can change, so current coaching information should be kept updated.
Use height for the human-readable height shown to readers.
Use height_cm as a numeric centimetre value for structured data. Do not include cm in this field.
Use weight for a human-readable weight only when useful to the sport.
Use weight_kg as a numeric kilogram value for structured data. Do not include kg in this field.
Weight can change frequently, especially in combat sports. Do not present a temporary weigh-in figure as a permanent biographical fact.
Use career_record for an established win-loss or equivalent career record when the sport commonly uses one.
Use highest_ranking for the athlete's highest official career ranking rather than a temporary current ranking.
Use titles for important championships or career titles.
Use medals for a concise summary of major medals.
Use records for major official records held or previously set by the athlete.
Use personal_bests only for sports where personal-best performances are meaningful.
Use education and alma_mater only when relevant to the biography.
Use awards for major individual sporting awards rather than every match award or minor honor.
Use family fields only when appropriate and supported by reliable sources.
Use website only for an official personal, federation, team, or professional page directly associated with the athlete.
url is accepted as an alias for website.
Do not add current betting odds, fantasy-sports values, transfer rumors, estimated transfer fees, temporary rankings, speculative injuries, or unconfirmed team moves.
Do not combine measurements, records, statistics, positions, or team information from different people or different career periods.
Leave unused parameters out.
Do not guess measurements, rankings, records, medals, team memberships, dates, or other sporting information.
Important claims should be supported by reliable sources.

Structured data

WikiPartner represents an individual athlete as Schema.org Person.

The athlete's profession is represented through hasOccupation and Schema.org Occupation.

The supplied sport, discipline, and competitive events may be represented through the person's skills.

Current professional and national teams may be represented through memberOf using Schema.org SportsTeam. A separately supplied sports club may be represented through affiliation using SportsOrganization.

When height_cm or weight_kg is supplied, WikiPartner emits Schema.org QuantitativeValue data with the correct measurement unit.

Fields such as position, coach, jersey number, former teams, career record, ranking, medals, titles, records, and personal bests remain visible encyclopedic information rather than being forced into unrelated structured-data properties.

TemplateData

WikiPartner's standard infobox for individual athletes and sportspeople, including footballers, cricketers, basketball players, tennis players, runners, swimmers, boxers, martial artists, and other notable competitors.

Template parameters
Parameter		Description	Type	Status
Name	`name`	Commonly recognized name of the athlete.	String	optional
Native name	`native_name`	Name in the athlete's native language or writing system.	String	optional
Other names	`other_name` `other_names`	Other widely recognized names, nicknames, or professional names.	String	optional
Birth name	`birth_name`	Name at birth when different from the commonly used name.	String	optional
Image	`image`	Main athlete portrait or action image filename without File markup.	File	optional
Image alternative text	`image_alt` `alt`	Short alternative text describing the image.	String	optional
Image caption	`caption`	Short caption displayed below the image.	String	optional
Birth date	`birth_date`	Human-readable birth date.	String	optional
Birth date ISO	`birth_date_iso`	Machine-readable birth date in YYYY, YYYY-MM, or YYYY-MM-DD format.	String	optional
Birth place	`birth_place`	Place where the athlete was born.	String	optional
Death date	`death_date`	Human-readable death date when applicable.	String	optional
Death date ISO	`death_date_iso`	Machine-readable death date in YYYY, YYYY-MM, or YYYY-MM-DD format.	String	optional
Death place	`death_place`	Place where the athlete died when applicable.	String	optional
Nationality	`nationality`	Athlete's nationality when relevant and reliably documented.	String	optional
Citizenship	`citizenship`	Athlete's citizenship when relevant and reliably documented.	String	optional
Occupation	`occupation`	Professional sporting occupation or occupations. Defaults to Athlete. Default Athlete	String	optional
Sport	`sport`	Primary sport, such as association football, tennis, athletics, cricket, or boxing.	String	optional
Discipline	`discipline`	Sporting discipline or specialization, such as sprinting, freestyle swimming, or singles tennis.	String	optional
Events	`events` `event`	Competitive events or categories. Separate multiple events with semicolons.	String	optional
Position	`position`	Playing position or role when the sport uses positions.	String	optional
Handedness	`handedness`	Playing hand or handedness when relevant, such as Right-handed or Left-handed.	String	optional
Playing style	`playing_style`	Recognized playing style when useful and reliably documented.	String	optional
Years active	`years_active`	Period during which the athlete has been professionally or internationally active.	String	optional
Debut	`debut`	Human-readable professional or senior debut information.	String	optional
Retired	`retired`	Retirement date or year when applicable.	String	optional
Representing	`representing`	Country or sporting delegation represented in competition when useful.	String	optional
Current team	`current_team` `team`	Current professional or club team when applicable.	String	optional
Club	`club`	Sports club or training club when distinct from the current team.	String	optional
National team	`national_team`	National team represented by the athlete when applicable.	String	optional
Former teams	`former_teams`	Important former professional or club teams. Keep the list concise.	String	optional
Jersey number	`jersey_number`	Current shirt, squad, or jersey number when relevant.	String	optional
League	`league`	Current or principal professional league when relevant.	String	optional
College team	`college_team`	College or university sports team when notable and relevant.	String	optional
Coach	`coach`	Current or major coach when reliably documented.	String	optional
Height	`height`	Human-readable height with units.	String	optional
Height in centimetres	`height_cm`	Numeric height in centimetres used for structured data.	Number	optional
Weight	`weight`	Human-readable weight with units when relevant.	String	optional
Weight in kilograms	`weight_kg`	Numeric weight in kilograms used for structured data.	Number	optional
Career record	`career_record`	Career win-loss or other recognized competition record when meaningful for the sport.	String	optional
Highest ranking	`highest_ranking`	Highest official career ranking achieved by the athlete.	String	optional
Titles	`titles`	Major championships or career titles won by the athlete.	String	optional
Medals	`medals`	Major medals or a concise medal summary.	String	optional
Records	`records`	Major official records held or previously set by the athlete.	String	optional
Personal bests	`personal_bests`	Important personal-best performances when meaningful for the sport.	String	optional
Education	`education`	Relevant educational background.	String	optional
Alma mater	`alma_mater`	Educational institutions attended or graduated from.	String	optional
Awards	`awards`	Major individual sporting or career awards.	String	optional
Spouse	`spouse`	Spouse when appropriate and reliably documented.	String	optional
Partner	`partner`	Long-term partner when appropriate and reliably documented.	String	optional
Children	`children`	Children when appropriate and reliably documented.	String	optional
Relatives	`relatives`	Notable relatives when relevant to the person's biography.	String	optional
Website	`website` `url`	Official personal, team, federation, or professional website directly associated with the athlete.	URL	optional