Template:MedalBox/doc

The {{Medal infobox}} series of templates allow editors to list an athlete or sportsperson's major medals at the top of their respective biography article, alongside the lead section.

Usage

The medal infobox consists of two templates:

• {{MedalTableTop}} – for starting the table where the other template(s) aren't in an infobox. Do not use {{MedalTableTop}} or {{MedalTop}} inside an infobox.
• {{Medal}} – for the several elements within the table

A further template ({{MedalBox}}) is used for listing medals in the middle of the main article text. Do not use {{MedalBox}} inside an infobox.

Parameters

MedalTableTop

Michael Johnson

Johnson at the London Olympic Stadium
Medal record
Men's athletics
Representing the United States

{{MedalTableTop
 | name         = Michael Johnson
 | image        = Michael Johnson at London Olympic Stadium 2010-07 1.JPG
 | image_size   = 180px
 | alt          = Alternative text here
 | caption      = Johnson at the London Olympic Stadium
 | sport        = Men's [[sport of athletics|athletics]]
 | country_code = USA
 | medals       = {{Medal|Sport}}
}}

Medal record
Women's basketball
Representing Poland
European Championships
	1999 Poland	Team competition

{{MedalTableTop
 | name    = no
 | sport   = Women's [[basketball]]
 | country = {{Bkw|POL}}
 | medals  = 
{{Medal|Competition|[[EuroBasket Women|European Championships]]}}
{{Medal|Gold|[[EuroBasket Women 1999|1999 Poland]]|Team competition}}
}}

Basic usage

{{MedalTableTop |name= |image= |image_size= |alt= |caption= |sport= |country_code= |medals= }}

{{MedalTableTop |name= |image= |image_size= |alt= |caption= |sport= |country= |medals= }}

• name – This option adjusts the title that appears at the top of the box. This should typically be the athlete's common name. By default it will display the article title without the disambiguator, for example on Michael Johnson (sprinter) "Michael Johnson" will appear by default. To deactivate the title enter no in the field.
• image – This give you the option to place a headline image in the infobox. Use just the file name and extension, excluding the namespace prefix, for example: MyImage.jpg not File:MyImage.jpg.
• image_size (or imagesize) – This adjusts the size of the image and must consist of a number followed by "px" (e.g. 150px). The default is 100px. Sizes over 200px are no recommended for typical usage.
• alt – This provides a description of the image for accessibility users or those using weak connections.
• caption – This adds a short description to describe the image. Try to be brief, using just a few words.
• header – This optional field can be used to change the text in the opening "Medal record" section. This is useful when the template appears in a section of an article. See Michael Phelps for a working example.
• sport – This option includes the athlete's sport (e.g. Men's swimming) in the first line of the medal record. This replaces the need for {{Medal|Sport}} when an athlete has medalled in only one sport. In cases where an athlete has competed in multiple sports, it is still possible to use the {{Medal|Sport}} template usage to list the different sports.
• country_code – This option uses the country code (e.g. USA = United States, CHN = China, GBN = Great Britain) to generate the country that the athlete represents in the second line of the medal record. It will automatically include "the" in front of the country name for the following codes: BHS (the Bahamas), GMB (the Gambia), GBR (the United Kingdom), MHL (the Marshall Islands), NLD (the Netherlands), PHL (the Philippines), SYC (the Seychelles), SLB (the Solomon Islands), ARE (the United Arab Emirates), URS (the Soviet Union), and USA (the United States). This replaces the need for {{Medal|Country}} when an athlete has competed for only one country. In cases where an athlete has represented multiple countries, it is still possible to use the {{Medal|Country}} template usage to list the different countries.
• country – May be used in place of country_code to display the country name using text or templates, such as {{BRA}} which displays Brazil (same output as with |country_code=BRA), {{Bkw|Poland}} which displays Poland (linked to the Poland women's national basketball team article), or {{Ih|CAN}} which displays Canada (linked to the Canada men's national ice hockey team article). Include "the" where appropriate (e.g. the {{BHS}}, the {{GMB}}, the {{GBR}}, the {{MHL}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{SLB}}, the {{ARE}}, the {{URS}}, the {{USA}}). This replaces the need for the {{Country}} template (e.g. {{Medal|Country|{{BRA}}}} or {{Medal|Country|{{Bkw|POL}}}}).
• medals – This is the only compulsory field as this is used to place medals and descriptions within the infobox through the {{Medal}} template. To work correctly, it must be the last field in the main template.

MedalBox

International medals
Men's beach volleyball
Representing Brazil
Olympic Games
	2012 London	Team

{{MedalBox
 | title   = International medals
 | sport   = Men's [[beach volleyball]]
 | country = {{BRA}}
 | medals  = 
{{Medal|Competition|[[Beach volleyball at the Summer Olympics|Olympic Games]]}}
{{Medal|Silver
  | [[Beach volleyball at the 2012 Summer Olympics|2012 London]]
  | [[Beach volleyball at the 2012 Summer Olympics – Men's tournament|Team]]
 }}
}}

The {{MedalBox}} template has a similar output to the {{MedalTableTop}} template, but it is specifically designed for non-infobox usages (i.e. mid-article boxes).

Basic usage

{{MedalBox |color= |title= |sport= |country= |medals= }}

• color – This option changes the color of the box header. If omitted, the default is light grey.
• title – This parameter allows you to customise the box title. If omitted, the default is "Medal record".
• sport – This displays the athlete's primary sport (e.g. "Men's beach volleyball"). This option supersedes the "{{Medal|Sport}}" template function.
• country – This displays the athlete's primary country or team using text or a template, such as {{BRA}} which displays Brazil (linked to the Brazil article), {{Bkw|Poland}} which displays Poland (linked to the Poland women's national basketball team article), or {{Ih|CAN}} which displays Canada (linked to the Canada men's national ice hockey team article). Include "the" where appropriate (e.g. the {{BHS}}, the {{GMB}}, the {{GBR}}, the {{MHL}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{SLB}}, the {{ARE}}, the {{URS}}, the {{USA}}). This replaces the need for the {{Medal|Country}} template (e.g. {{Medal|Country|{{BRA}}}} or {{Medal|Country|{{Bkw|POL}}}}).
• medals – This is the only compulsory field as this is used to place medals and descriptions within the box through the {{Medal}} template. To work correctly it must be the last field in the main template.

Medal

Medal record
Men's athletics
Representing the United States
Olympic Games
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
Winner	2012 TEST	100 m
Winner	2012 TEST	100 m
Runner-up	2012 TEST	100 m
Runner-up	2012 TEST	100 m
Runner-up	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
	2012 TEST	100 m
Disqualified	2012 TEST	100 m
Disqualified	2012 TEST	100 m
	Pierre de Coubertin medal	2012
	Pierre de Coubertin medal	2012
Men's bobsled
Representing Jamaica
World Bobsled Championships
Disqualified	2013 TEST	Bobsled

{{MedalTableTop
 | name         = no
 | sport        = Men's [[sport of athletics|athletics]]
 | country_code = USA
 | medals       = 
{{Medal|Competition|[[Olympic Games]]}}
{{Medal|Gold|2012 TEST|100 m}}
{{Medal|G|2012 TEST|100 m}}
{{Medal|Silver|2012 TEST|100 m}}
{{Medal|S|2012 TEST|100 m}}
{{Medal|Bronze|2012 TEST|100 m}}
{{Medal|B|2012 TEST|100 m}}
{{Medal|Winner|2012 TEST|100 m}}
{{Medal|W|2012 TEST|100 m}}
{{Medal|Runnerup|2012 TEST|100 m}}
{{Medal|Runner-up|2012 TEST|100 m}}
{{Medal|RU|2012 TEST|100 m}}
{{Medal|First|2012 TEST|100 m}}
{{Medal|1st|2012 TEST|100 m}}
{{Medal|Second|2012 TEST|100 m}}
{{Medal|2nd|2012 TEST|100 m}}
{{Medal|Third|2012 TEST|100 m}}
{{Medal|3rd|2012 TEST|100 m}}
{{Medal|Disqualified|2012 TEST|100 m}}
{{Medal|DQ|2012 TEST|100 m}}
{{Medal|TrueSpirit|2012}}
{{Medal|PdC|2012}}
{{Medal|Sport|Men's [[Bobsleigh|bobsled]]}}
{{Medal|Country|{{JAM}}}}
{{Medal|Comp|World Bobsled Championships}}
{{Medal|DQ|2013 TEST|Bobsled}}
}}

The Medal template is multi-purpose and allows for all varieties of entries within the medal table.

Basic usage

{{Medal|TYPE|FIELD1|FIELD2}}

There are four major types:

• Competition – This states the general competition at which the following medals were achieved (e.g. Olympic Games, Pan Pacific Swimming Championships)
• Medal performances – There are ten types of medal performances. These contain two separate fields for the year of the competition and its location (e.g. 2008 Beijing, 2010 Delhi) and the medalling event or category (e.g. pole vault, 56 kg, 50 m freestyle). The medal types are (with shortcut in brackets):
  • Gold (G)
  • Silver (S)
  • Bronze (B)
  • Winner (W)
  • Runnerup (RU)
  • First (1st)
  • Second (2nd)
  • Third (3rd)
  • Disqualified (DQ)
  • TrueSpirit (PdC)

Disqualified

Medal record
Disqualified	2012 TEST	100 m

{{MedalTableTop|name=no|medals=
{{Medal|Disqualified|2012 TEST|100 m}}<ref>Reason for disqualification.</ref>
}}

For the disqualified medal template, it is possible to create a reference directly after the template to explain the reason for disqualification. This can be particularly useful in the case of relay runners disqualified through no fault of their own, due to doping by team mates for example.

TrueSpirit

Medal record
	Pierre de Coubertin medal	2012

{{MedalTableTop|name=no|medals=
{{Medal|TrueSpirit|2012}}
}}

The final medal performances type is used for the Pierre de Coubertin Medal. This has only one extra field for the year it was awarded.

Multiple countries/sports

Medal record
Men's road bicycle racing
Representing Great Britain
Olympic Games
	2012 London	Event
Men's triathlon
Representing England
Commonwealth Games
	2014 Glasgow	Event

{{MedalTableTop
 | name         = no
 | sport        = Men's [[road bicycle racing]]
 | country_code = GBN
 | medals       = 
{{Medal|Comp|[[Olympic Games]]}}
{{Medal|Bronze|[[2012 Summer Olympics|2012 London]]|Event}}
{{Medal|Sport|Men's [[triathlon]]}}
{{Medal|Country|{{ENG}}}}
{{Medal|Comp|[[Commonwealth Games]]}}
{{Medal|Gold|[[2014 Commonwealth Games|2014 Glasgow]]|Event}}
}}

Medal record
Men's road bicycle racing
Representing Great Britain
Olympic Games
	2012 London	Event
Men's triathlon
Representing England
Commonwealth Games
	2014 Glasgow	Event

{{MedalBox
 | sport   = Men's [[road bicycle racing]]
 | country = {{GBN}}
 | medals  = 
{{Medal|Comp|[[Olympic Games]]}}
{{Medal|Bronze|[[2012 Summer Olympics|2012 London]]|Event}}
{{Medal|Sport|Men's [[triathlon]]}}
{{Medal|Country|{{ENG}}}}
{{Medal|Comp|[[Commonwealth Games]]}}
{{Medal|Gold|[[2014 Commonwealth Games|2014 Glasgow]]|Event}}
}}

Where an athlete has competed for multiple countries or in multiple sports it will be necessary to use the Country or Sport Medal types, in addition to the main sport and country_code listings in the {{MedalTableTop}} template.

• Relevant country (or team) – This is usually the first section showing the person's relevant country (or team).
  • Country – Enter the country's three-letter IOC code in curly brackets (e.g. {{CHN}}), including "the" where appropriate (e.g. the {{USA}}, the {{URS}}, the {{MHL}}, the {{ARE}}, the {{GBR}}, the {{BHS}}, the {{NLD}}, the {{PHL}}, the {{SYC}}, the {{GMB}}, the {{SLB}}). In rare cases, the correct input may be something else (e.g. a team name).
  • Independent - This is used for independent athletes.
• Sport – This states the sport that the athlete is competing in (e.g. Women's swimming)

Examples

MedalTableTop

For competitors who have competed in the same sport for the same country, the templates should be ordered Sport, Country, Competition1, Award, Competition2, Award and so on.

Athlete name

Medal record
Men's athletics
Representing Australia
Olympic Games
	2000 Sydney	100 m
Commonwealth Games
	2006 Melbourne	200 m
	2006 Melbourne	400 m

{{MedalTableTop
 | name         = Athlete name
 | image        = Example-serious.jpg
 | image_size   = 150px
 | alt          = Alt text for image
 | sport        = Men's [[sport of athletics|athletics]]
 | country_code = AUS
 | medals       = 
{{Medal|Competition|[[Athletics at the Summer Olympics|Olympic Games]]}}
{{Medal|Gold
  | [[Athletics at the 2000 Summer Olympics|2000 Sydney]]
  | [[Athletics at the 2000 Summer Olympics – Men's 100 metres|100 m]]
 }}
{{Medal|Competition|[[Athletics at the Commonwealth Games|Commonwealth Games]]}}
{{Medal|Silver
  | [[Athletics at the 2006 Commonwealth Games|2006 Melbourne]]
  | [[Athletics at the 2006 Commonwealth Games – Men's 200 metres|200 m]]
 }}
{{Medal|Bronze|2006 Melbourne|[[Athletics at the 2006 Commonwealth Games – Men's 400 metres|400 m]]}}
}}

Competitor who has won medals in different sports, competing for the same country

MedalBox/doc

Medal record
Representing Great Britain
Women's rowing
Olympic Games
	2004 Athens	Quadruple sculls
Women's track cycling
Olympic Games
	2008 Beijing	Individual pursuit

{{MedalTableTop
 | country_code = GBN
 | medals       = 
{{Medal|Sport|Women's [[Rowing (sport)|rowing]]}}
{{Medal|Competition|[[Rowing at the Summer Olympics|Olympic Games]]}}
{{Medal|Silver
  | [[Rowing at the 2004 Summer Olympics|2004 Athens]]
  | [[Rowing at the 2004 Summer Olympics – Women's quadruple sculls|Quadruple sculls]]
 }}
{{Medal|Sport|Women's [[track cycling]]}}
{{Medal|Competition|[[Cycling at the Summer Olympics|Olympic Games]]}}
{{Medal|Gold
  | [[Cycling at the 2008 Summer Olympics|2008 Beijing]]
  | [[Cycling at the 2008 Summer Olympics – Women's individual pursuit|Individual pursuit]]
 }}
}}

For competitors who have won medals in different sports, competing for the same country, the templates should be ordered Country, Sport1, Competition, Award, Sport2, Competition, Award and so on. The example shown is based on Rebecca Romero.

Competitor who has won medals in the same sport, competing for different countries

MedalBox/doc

Medal record
Women's badminton
Olympic Games
Representing Indonesia
	1996 Atlanta	Singles
Representing the Netherlands
	2004 Athens	Singles

{{MedalTableTop
 | sport  = Women's [[badminton]]
 | medals = 
{{Medal|Competition|[[Badminton at the Summer Olympics|Olympic Games]]}}
{{Medal|Country|{{IDN}}}}
{{Medal|Silver
  | [[Badminton at the 1996 Summer Olympics|1996 Atlanta]]
  | [[Badminton at the 1996 Summer Olympics – Women's singles|Singles]]
 }}
{{Medal|Country|the {{NLD}}}}
{{Medal|Silver
  | [[Badminton at the 2004 Summer Olympics|2004 Athens]]
  | [[Badminton at the 2004 Summer Olympics – Women's singles|Singles]]
 }}
}}

For competitors who have won medals in the same sport at the same competition, competing for different countries, the templates should be ordered Sport, Competition, Country1, Award, Country2, Award and so on. The example shown is from Mia Audina.

MedalBox/doc

Medal record
Women's badminton
Representing Denmark
Olympic Games
	1996 Atlanta	Singles
European Championships
	2002 Malmö	Singles
Representing Sweden
Olympic Games
	2004 Athens	Singles

{{MedalTableTop
 | sport  = Women's [[badminton]]
 | medals = 
{{Medal|Country|{{DNK}}}}
{{Medal|Competition|[[Badminton at the Summer Olympics|Olympic Games]]}}
{{Medal|Silver
  | [[Badminton at the 1996 Summer Olympics|1996 Atlanta]]
  | [[Badminton at the 1996 Summer Olympics – Women's singles|Singles]]
 }}
{{Medal|Competition|[[European Badminton Championships|European Championships]]}}
{{Medal|Bronze|[[2002 European Badminton Championships|2002 Malmö]]|Singles}}
{{Medal|Country|{{SWE}}}}
{{Medal|Competition|Olympic Games}}
{{Medal|Silver
  | [[Badminton at the 2004 Summer Olympics|2004 Athens]]
  | [[Badminton at the 2004 Summer Olympics – Women's singles|Singles]]
 }}
}}

For competitors who have won medals in the same sport at different competitions, competing for different countries, the templates should be ordered Sport, Country1, Competition1, Award, Competition2, Award, Country2, Competition1, Award and so on.

Medal table embedded within an infobox

Allison Schmitt

Personal information
Full name	Allison Rodgers Schmitt
Nicknames	"Schmitty" "Al" "Allie"
National team	United States
Born	(1990-06-07) June 7, 1990 Pittsburgh, Pennsylvania, U.S.
Height	6 ft 1 in (185 cm)
Weight	163 lb (74 kg)
Sport
Sport	Swimming
Strokes	Freestyle
Club	Ann Arbor Swim Club Club Wolverine Athens Bulldog Swim Club North Baltimore Aquatic Club
College team	University of Georgia
Medal record Women's swimming Representing the United States Event 1st 2nd 3rd World Championships (SC) 3 0 0 Pan Pacific Championships 2 0 0 Total 5 0 0 World Championships (SC) 2012 Istanbul 200 m freestyle 2012 Istanbul 4×100 m freestyle 2012 Istanbul 4×200 m freestyle Pan Pacific Championships 2010 Irvine 200 m freestyle 2010 Irvine 4×200 m freestyle

{{Infobox swimmer
 | name            = Allison Schmitt
 | full_name       = Allison Rodgers Schmitt
 | nickname        = {{Cslist|"Schmitty"|"Al"|"Allie"}}
 | national_team   = {{USA}}
 | birth_date      = {{Birth date and age|1990|6|7|mf=y}}
 | birth_place     = [[Pittsburgh]], [[Pennsylvania]], U.S.
 | height          = 6 ft 1 in
 | weight          = 163 lb
 | strokes         = [[Freestyle swimming|Freestyle]]
 | club            = {{Unbulleted indent list
   | Ann Arbor Swim Club
   | Club Wolverine
   | Athens Bulldog Swim Club
   | [[North Baltimore Aquatic Club]]
  }}
 | college_team    = [[Georgia Bulldogs swimming and diving|University of Georgia]]
 | show_medals     = yes
 | medal_templates = 
{{Medal|Sport|Women's swimming}}
{{Medal|Country|the United States}}
{{MedalCount
  | [[World Aquatics Swimming Championships (25m)|World Championships (SC)]] | 3 | 0 | 0
  | [[Pan Pacific Swimming Championships|Pan Pacific Championships]] | 2 | 0 | 0
  | total = yes
 }}
{{Medal|Competition|[[World Aquatics Swimming Championships (25m)|World Championships (SC)]]}}
{{Medal|Gold
  | [[2012 FINA World Swimming Championships (25 m)|2012 Istanbul]]
  | [[2012 FINA World Swimming Championships (25 m) – Women's 200 metre freestyle|200 m freestyle]]
 }}
{{Medal|Gold
  | 2012 Istanbul
  | [[2012 FINA World Swimming Championships (25 m) – Women's 4 × 100 metre freestyle relay|4×100 m freestyle]]
 }}
{{Medal|Gold
  | 2012 Istanbul
  | [[2012 FINA World Swimming Championships (25 m) – Women's 4 × 200 metre freestyle relay|4×200 m freestyle]]
 }}
{{Medal|Competition|[[Pan Pacific Swimming Championships|Pan Pacific Championships]]}}
{{Medal|Gold
  | [[2010 Pan Pacific Swimming Championships|2010 Irvine]]
  | [[2010 Pan Pacific Swimming Championships – Women's 200 metre freestyle|200 m freestyle]]
 }}
{{Medal|Gold
  | 2010 Irvine
  | [[Swimming at the 2015 Pan American Games – Women's 4 × 200 metre freestyle relay|4×200 m freestyle]]
 }}
}}

For use within {{Infobox biathlete}}, {{Infobox fencer}}, {{Infobox figure skater}}, {{Infobox sailor}}, {{Infobox swimmer}} and other infobox templates that are wrappers for Infobox sportsperson have an "embed" function for the medal table. Formatting for the medal table embedded within an infobox generally follows the established formatting of the other examples provided, but duplicate wiki links for the sport name ("MedalSport") and represented country ("MedalCountry") may be eliminated within the embedded medal table.

MedalBox

Here is a basic demonstration of the MedalBox template usage:

International medals
Men's ice hockey
Representing Canada
World Junior Championships
	2020 Ostrava/Třinec
	2021 Edmonton
World U18 Championship
	2024 Finland
Hlinka Gretzky Cup
	2023 Czech Republic/Slovakia

{{MedalBox|title=International medals|sport=Men's [[ice hockey]]|country={{Ih|CAN}}|medals=
{{Medal|Competition|[[IIHF World Junior Championship|World Junior Championships]]}}
{{Medal|Gold|[[2020 World Junior Ice Hockey Championships|2020 Ostrava/Třinec]]}}
{{Medal|Silver|[[2021 World Junior Ice Hockey Championships|2021 Edmonton]]}}
{{Medal|Competition|[[IIHF World U18 Championship|World U18 Championship]]}}
{{Medal|Gold|[[2024 IIHF World U18 Championships|2024 Finland]]}}
{{Medal|Competition|[[Hlinka Gretzky Cup]]}}
{{Medal|Gold|[[2023 Hlinka Gretzky Cup|2023 Czech Republic/Slovakia]]}}
}}

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:MedalBox in articles based on its TemplateData.

TemplateData for MedalBox

This section contains TemplateData that is invisible except when viewed on the page it refers to.

Historical templates

Deprecated TableTop templates

• {{MedalTop}} – use {{MedalTableTop}} with {{Medal|Competition|Olympic Games}}
• {{MedalTop3}} – (for Paralympic Games) use {{MedalTableTop}}
• {{MedalTableTopPic}} – use {{MedalTableTop}} with the same parameters

Deprecated competition templates

• {{MedalOlympics}} – use {{Medal|Competition|Olympic Games}}
• {{MedalParalympic}} – use {{Medal|Competition|Paralympic Games}}
• {{MedalWorldChampionships}} – use {{Medal|Competition|World Championships}}
• {{MedalEuropeanChampionships}} – use {{Medal|Competition|European Championships}}

Deprecated Medal templates

• {{MedalGold}}
• {{MedalSilver}}
• {{MedalBronze}}

For competitions differing from gold, silver and bronze rubrics

• {{MedalW}}
• {{MedalRU}}

Alias for {{Medal|Sport|text}}

• {{MedalSport}} – Use {{Medal|Sport|text}}

Deprecated closing template

• {{MedalBottom}} – table now automatically closes by using the |medals= parameter and medal templates prior to the final paired curly brackets at the end of the template.