View source for Template:Infobox football league season/doc

{{Documentation subpage}}
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{#ifeq:{{SUBPAGENAME}}|sandbox||{{High-use}}}}
{{auto short description}}

{{Parameter names example|_template=| competition | logo | image | pixels | alt | caption | season | dates | mlscup | American | winners | shieldtitle | shield | premiers | promoted | relegated | continentalcup1 | continentalcup1 qualifiers | continentalcup2 | continentalcup2 qualifiers | continentalcup3 | continentalcup3 qualifiers | continentalcup4 | continentalcup4 qualifiers | matches | matches footnote | total goals | total goals footnote | average goals | best player | league topscorer | best goalkeeper | biggest home win | biggest away win | highest scoring | longest wins | longest unbeaten | longest winless | longest losses | highest attendance | lowest attendance | attendance | average attendance | prevseason | nextseason | updated | extra information}}

== Usage ==
<pre style="overflow: auto;">
{{Infobox football league season
| competition               = 
| logo                      = 
| image                     = 
| pixels                    = <!-- width of image in pixels (px) -->
| alt                       = 
| caption                   = 
| season                    = 
| dates                     = 
| mlscup                    = <!-- for MLS only; supersedes "winners" parameter -->
| winners                   = 
| American                  = <!-- changes "Champions" to "Champion(s)" -->
| shieldtitle               = 
| shield                    = 
| premiers                  = 
| promoted                  = 
| relegated                 = 
| continentalcup1           = 
| continentalcup1 qualifiers= 
| continentalcup2           = 
| continentalcup2 qualifiers= 
| continentalcup3           = 
| continentalcup3 qualifiers= 
| continentalcup4           = 
| continentalcup4 qualifiers= 
| matches                   = <!-- no commas -->
| matches footnote          = 
| total goals               = 
| total goals footnote      = 
| average goals             = 
| best player               = 
| league topscorer          = 
| best goalkeeper           = 
| biggest home win          = 
| biggest away win          = 
| highest scoring           = 
| longest wins              = 
| longest unbeaten          = 
| longest winless           = 
| longest losses            = 
| highest attendance        = 
| lowest attendance         = 
| attendance                = 
| average attendance        = 
| prevseason                = 
| nextseason                = 
| updated                   = 
| extra information         = 
}}
</pre>

== Parameters ==

All parameters are optional.
* <nowiki>{{{competition}}}</nowiki> &mdash; The commonly-used name of the competition (including sponsorship). If this is omitted, it will be automatically derived from the article title.
* <nowiki>{{{dates}}}</nowiki> &mdash; The dates of the first and last matches played in the season, separated by an endash
* <nowiki>{{{winners}}}</nowiki> &mdash; Champions
* <nowiki>{{{mlscup}}}</nowiki> &mdash; MLS Cup winners. Note that this supersedes the {{{winners}}} field.
* <nowiki>{{{shieldtitle}}}</nowiki> &mdash; The name of the title given to the regular season winners if not "Supporters' Shield" (where applicable)
* <nowiki>{{{shield}}}</nowiki> &mdash; Supporters' Shield winners (where applicable)
* <nowiki>{{{promoted}}}</nowiki> &mdash; promoted (if any)
* <nowiki>{{{relegated}}}</nowiki> &mdash; relegated (if any)
* <nowiki>{{{continentalcup1}}}</nowiki> &mdash; Continental cup1, e.g., Champions League
* <nowiki>{{{continentalcup1 qualifiers}}}</nowiki> &mdash; Continental cup1 qualifiers
* <nowiki>{{{matches}}}</nowiki> &mdash; Total number of matches played
* <nowiki>{{{total goals}}}</nowiki> &mdash; Total number of goals scored.  Works with *<nowiki>{{{matches}}}</nowiki> to provide average goals scored.
* <nowiki>{{{average goals}}}</nowiki> &mdash; Manual input of average goals scored.  Round to 2 decimal places.
* <nowiki>{{{league topscorer}}}</nowiki> &mdash; The name of the top scorer in the domestic league level, and the number of scored goals, in the form "''Footballer (goals)''".
* <nowiki>{{{best goalkeeper}}}</nowiki> &mdash; The name of the best goalkeeper in the domestic league level, and the number of clean sheets or goals-to-games ratio, in the form "''Goalkeeper (clean sheets/goals-to-games ratio)''".
''Note: If dates are to be added to the matches, these must be accompanied by a source containing the date of the match.''
* <nowiki>{{{biggest home win}}}</nowiki> &mdash; Result (date)
* <nowiki>{{{biggest away win}}}</nowiki> &mdash; As above
* <nowiki>{{{biggest win}}}</nowiki> &mdash; As above, mutually exclusive with <nowiki>{{{biggest home win}}}</nowiki>, which takes precedence
* <nowiki>{{{highest scoring}}}</nowiki> &mdash; As above
''Note: The following parameters require a mandatory source which explicitly states that the streak is a record. Taking the information from a fixture/results list would consist [[WP:OR|original research]] as these lists usually do not point out any streaks. If a source cannot be provided, please do not add any data for these parameters.''
* <nowiki>{{{longest wins}}}</nowiki> &mdash; No. games - team (date from-date to)
* <nowiki>{{{longest unbeaten}}}</nowiki> &mdash; As above
* <nowiki>{{{longest winless}}}</nowiki> &mdash; As above
* <nowiki>{{{longest losses}}}</nowiki> &mdash; As above
* <nowiki>{{{highest attendance}}}</nowiki> &mdash; Attendance - match (date)
* <nowiki>{{{lowest attendance}}}</nowiki> &mdash; As above
* <nowiki>{{{attendance}}}</nowiki> &mdash; Total Attendance for season. Average attendance per match is calculated automatically when {{para|matches}} has a number in it.
* <nowiki>{{{attendance note}}}</nowiki> &mdash; A reference or note about the attendance. Include {{tag|ref}} tags or {{tl|efn}} as appropriate.
* <nowiki>{{{extra information}}}</nowiki> &mdash; Any additional information about the season, if any.
* <nowiki>{{{updated}}}</nowiki> &mdash; The date/time at which the season's infobox and article were most recently updated.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"image": {
			"required": false,
			"label": "Image",
			"type": "wiki-page-name",
			"description": "Image of logo of the league."
		},
		"pixels": {
			"required": false,
			"label": "Pixels",
			"type": "number",
			"description": "Width of the image in pixels"
		},
		"caption": {
			"required": false,
			"label": "Image Caption",
			"type": "string",
			"description": "Caption for the image that is provided"
		},
		"competition": {
			"required": false,
			"label": "Competition",
			"type": "string",
			"description": "Commonly used name of competition",
			"example": "[[Premier League]]"
		},
		"winners": {
			"required": false,
			"label": "Winners",
			"type": "string",
			"description": "Champions of the competition.",
			"example": "[[Manchester City F.C.|Manchester City]]"
		},
		"premiers": {
			"required": false,
			"label": "Premiers",
			"type": "string",
			"description": "League's Premier"
		},
		"promoted": {
			"required": false,
			"label": "Promoted",
			"type": "string",
			"description": "Promoted(if any)",
			"example": "[[Swansea City A.F.C.|Swansea City]]<br />[[Stoke City F.C.|Stoke City]]"
		},
		"relegated": {
			"required": false,
			"label": "Relegated",
			"type": "string",
			"description": "Relegated(if any)",
			"example": "[[Swansea City A.F.C.|Swansea City]]<br />[[Stoke City F.C.|Stoke City]]"
		},
		"Dissolved": {
			"required": false,
			"label": "Dissolved",
			"type": "string",
			"description": "Dissolved"
		},
		"continentalcup1": {
			"required": false,
			"label": "Continental Cup 1",
			"type": "string",
			"description": "Continental Cup1",
			"example": "[[2018–19 UEFA Champions League|Champions League]]"
		},
		"continentalcup1 qualifiers": {
			"required": false,
			"label": "Continental Cup1 Qualifiers",
			"type": "string",
			"description": "Qualifiers for continental cup 1",
			"example": "[[Manchester United F.C.|Manchester United]]<br />[[Tottenham Hotspur F.C.|Tottenham Hotspur]]"
		},
		"continentalcup2": {
			"required": false,
			"label": "Continental cup 2",
			"type": "string",
			"description": "Continental Cup 2 ",
			"example": "[[2018–19 UEFA Europa League|Europa League]]"
		},
		"continentalcup2 qualifiers": {
			"required": false,
			"label": "Continental Cup2 Qualifiers",
			"type": "string",
			"description": "Qualifiers for continental cup 2",
			"example": "[[Chelsea F.C.|Chelsea]]<br />[[Arsenal F.C.|Arsenal]]"
		},
		"matches": {
			"required": false,
			"label": "Matches played",
			"type": "number",
			"description": "Total matches played",
			"example": "380"
		},
		"total goals": {
			"required": false,
			"label": "Goals scored",
			"type": "number",
			"description": "Total Goals scored",
			"example": "1018"
		},
		"average goals": {
			"required": false,
			"label": "Average goals/game",
			"type": "string",
			"description": "Manual input of average goals scored. Round to 2 decimal places"
		},
		"league topscorer": {
			"required": false,
			"label": "Top goalscorer",
			"type": "string",
			"description": "The name of league's top scorer",
			"example": "[[Mohamed Salah]]<br />(32 goals)<ref name=topscorer />"
		},
		"biggest home win": {
			"required": false,
			"label": "Biggest home win",
			"type": "line",
			"description": "Result (with date)"
		},
		"biggest away win": {
			"required": false,
			"label": "Biggest away win",
			"type": "line",
			"description": "Result (with date)"
		},
		"highest scoring": {
			"required": false,
			"label": "Highest Scoring",
			"type": "line",
			"description": "Result (with date)"
		},
		"longest wins": {
			"required": false,
			"label": "Longest Wins",
			"type": "line",
			"description": "No. of games won - Team(date from - date to)"
		},
		"longest unbeaten": {
			"required": false,
			"label": "Longest Unbeaten",
			"type": "line",
			"description": "No. of games won - Team(date from - date to)"
		},
		"longest winless": {
			"required": false,
			"label": "Longest winless",
			"type": "line",
			"description": "No. of games lost - Team(date from - date to)"
		},
		"longest losses": {
			"required": false,
			"label": "Longest losses",
			"type": "line",
			"description": "No. of games lost - Team(date from - date to)"
		},
		"highest attendance": {
			"required": false,
			"label": "Highest Attendance",
			"type": "line",
			"description": "Attendance (with date)"
		},
		"lowest attendance": {
			"required": false,
			"label": "Lowest Attendance",
			"type": "line",
			"description": "Attendance (with date)"
		},
		"attendance": {
			"required": false,
			"label": "Attendance",
			"type": "number",
			"description": "Total attendance for season"
		},
		"average attendance": {
			"required": false,
			"label": "Average Attendance",
			"type": "number",
			"description": "Average attendance for season"
		},
		"prevseason": {
			"required": false,
			"label": "Previous Season",
			"type": "wiki-page-name",
			"description": "Link to the page of the previous season"
		},
		"nextseason": {
			"required": false,
			"label": "Next Season",
			"type": "wiki-page-name",
			"description": "Link to the page of the next season"
		},
		"extra information": {
			"required": false,
			"label": "Extra Information",
			"type": "string",
			"description": "Any additional information about the season"
		},
		"updated": {
			"required": false,
			"label": "Updated",
			"type": "line",
			"description": "The date/time at which the infobox was most recently updated"
		},
		"dates": {
			"label": "Dates",
			"description": "The dates of the first and last matches played in the season, separated by an endash",
			"example": "11 August 2017 – 13 May 2018",
			"type": "date"
		},
		"season": {
			"label": "Season",
			"description": "season of the competition",
			"example": "[[2017–18 in English football|2017–18]]",
			"type": "string"
		},
		"matches footnote": {
			"label": "Matches Footnote",
			"description": "Footnote that appears under the number of matches"
		},
		"best player": {
			"label": "Best player",
			"description": "The name of league's official best player",
			"type": "string"
		},
		"best goalkeeper": {
			"label": "Best goalkeeper",
			"description": "The name of league's official best goalkeeper",
			"type": "string"
		}
	},
	"description": "Infobox to use in football league season's articles",
	"paramOrder": [
		"image",
		"pixels",
		"caption",
		"competition",
		"season",
		"dates",
		"winners",
		"premiers",
		"promoted",
		"relegated",
		"Dissolved",
		"continentalcup1",
		"continentalcup1 qualifiers",
		"continentalcup2",
		"continentalcup2 qualifiers",
		"matches",
		"matches footnote",
		"total goals",
		"average goals",
		"best player",
		"league topscorer",
		"best goalkeeper",
		"biggest home win",
		"biggest away win",
		"highest scoring",
		"longest wins",
		"longest unbeaten",
		"longest winless",
		"longest losses",
		"highest attendance",
		"lowest attendance",
		"attendance",
		"average attendance",
		"prevseason",
		"nextseason",
		"updated",
		"extra information"
	],
	"format": "block"
}

</templatedata>

== Example ==

The input:
<pre style="overflow:auto">
{{Infobox football league season
| competition                = La Liga
| season                     = 2011–12
| dates                      = 27 August 2011 – 13 May 2012
| winners                    = [[Real Madrid CF|Real Madrid]]<br>32nd title
| relegated                  = [[Villareal CF|Villarreal]] <br> [[Sporting de Gijón]] <br> [[Racing de Santander|Racing Santander]]
| continentalcup1            = [[2012–13 UEFA Champions League|Champions League]]
| continentalcup1 qualifiers = [[Real Madrid CF|Real Madrid]]<br>[[FC Barcelona|Barcelona]]<br>[[Valencia CF|Valencia]]<br>[[Málaga CF| Málaga]]
| continentalcup2            = [[2012–13 UEFA Europa League|Europa League]]
| continentalcup2 qualifiers = [[Athletic Bilbao]]<br/>[[Atlético Madrid]]<br>[[Levante UD|Levante]]
| best player                = [[Cristiano Ronaldo]]
| league topscorer           = [[Lionel Messi]] (50)
| best goalkeeper            = [[Víctor Valdés]]<br />(0.8 goals conceded per game)
| biggest home win           = [[FC Barcelona|Barcelona]]&nbsp;8–0&nbsp;[[CA Osasuna|Osasuna]] (17&nbsp;September&nbsp;2011)
| biggest away win           = [[Rayo Vallecano]]&nbsp;0–7&nbsp;[[FC Barcelona|Barcelona]] (29&nbsp;April&nbsp;2012)<ref name="Rayo Vallecano 0-7 Barcelona">{{cite web|title=Rayo Vallecano 0-7 Barcelona|url=http://actas.rfef.es/actas/RFEF_CmpPartido?cod_primaria=1000144&CodActa=16983|publisher=[[Royal Spanish Football Federation|RFEF]]|date=29 April 2012 |accessdate=29 April 2012|language=Spanish}}</ref>
| highest scoring            = [[FC Barcelona|Barcelona]]&nbsp;8–0&nbsp;[[CA Osasuna|Osasuna]] (17&nbsp;September&nbsp;2011)<br>
[[Real Madrid CF|Real&nbsp;Madrid]]&nbsp;6–2&nbsp;[[Rayo Vallecano|Rayo&nbsp;Vallecano]] (24&nbsp;September&nbsp;2011) <br>
[[Real Madrid CF|Real&nbsp;Madrid]]&nbsp;7–1&nbsp;[[CA Osasuna|Osasuna]] (6&nbsp;November&nbsp;2011)<br/>
[[Sevilla FC|Sevilla]]&nbsp;2–6&nbsp;[[Real Madrid CF|Real&nbsp;Madrid]] (17&nbsp;December&nbsp;2011)<br>
[[Levante UD|Levante]]&nbsp;3–5&nbsp;[[Rayo Vallecano|Rayo&nbsp;Vallecano]] (19&nbsp;February&nbsp;2012)
[[FC Barcelona|Barcelona]]&nbsp;5–3&nbsp;[[Granada CF|Granada]] (20&nbsp;March&nbsp;2012)
| matches                    = 380
| total goals                = 1050
| longest wins               = 11 games by [[Real Madrid CF|Real Madrid]] and [[FC Barcelona|Barcelona]]<ref name="Soccernet">{{cite web|title=Spanish La Liga statistics|url=http://soccernet.espn.go.com/stats/_/league/esp.1/spanish-primera-division?cc=5739|publisher=[[ESPNsoccernet]]|accessdate=29 August 2011}}</ref>
| longest unbeaten           = 23 games by [[Real Madrid CF|Real&nbsp;Madrid]]<ref name=Soccernet/>
| longest winless            = 20 games by [[Racing de Santander|Racing&nbsp;Santander]]<ref name=Soccernet/>
| longest losses             = 6 games by [[Real Betis|Betis]], [[Rayo Vallecano]] and [[Real Zaragoza|Zaragoza]]<ref name=Soccernet/>
| highest attendance         = 99,252<ref>{{cite web|title=Barcelona&nbsp;— Real Madrid, 04/21/2012 |url=http://www.fcbarcelona.com/football/first-team/match-archive/2011-2012/league/round-35/fc-barcelona_real-madrid/info |publisher=fcbarcelona.com|accessdate=22 April 2012}}</ref> [[FC Barcelona|Barcelona]]&nbsp;–&nbsp;[[Real Madrid CF|Real Madrid]]
| lowest attendance          = 6,000<ref name=Soccernet/> [[Getafe CF|Getafe]]&nbsp;–&nbsp;[[Racing de Santander|Racing Santander]]
| attendance                 = 11,504,567<ref name=Soccernet/>
| average attendance         = 30,275<ref name=Soccernet/>
| prevseason                 = [[2010–11 La Liga|2010–11]]
| nextseason                 = [[2012–13 La Liga|2012–13]]
}}
</pre>

produces

{{Infobox football league season
| competition                = La Liga
| season                     = 2011–12
| dates                      = 27 August 2011 – 13 May 2012
| winners                    = [[Real Madrid CF|Real Madrid]]<br>32nd title
| relegated                  = [[Villareal CF|Villarreal]] <br> [[Sporting de Gijón]] <br> [[Racing de Santander|Racing Santander]]
| continentalcup1            = [[2012–13 UEFA Champions League|Champions League]]
| continentalcup1 qualifiers = [[Real Madrid CF|Real Madrid]]<br>[[FC Barcelona|Barcelona]]<br>[[Valencia CF|Valencia]]<br>[[Málaga CF|Málaga]]
| continentalcup2            = [[2012–13 UEFA Europa League|Europa League]]
| continentalcup2 qualifiers = [[Athletic Bilbao]]<br/>[[Atlético Madrid]]<br>[[Levante UD|Levante]]
| league topscorer           = [[Lionel Messi]] (50)
| best goalkeeper            = [[Víctor Valdés]]<br />(0.8 goals conceded per game)
| biggest home win           = [[FC Barcelona|Barcelona]]&nbsp;8–0&nbsp;[[CA Osasuna|Osasuna]] (17&nbsp;September&nbsp;2011)
| biggest away win           = [[Rayo Vallecano]]&nbsp;0–7&nbsp;[[FC Barcelona|Barcelona]] (29&nbsp;April&nbsp;2012)<ref name="Rayo Vallecano 0-7 Barcelona">{{cite web|title=Rayo Vallecano 0-7 Barcelona|url=http://actas.rfef.es/actas/RFEF_CmpPartido?cod_primaria=1000144&CodActa=16983|publisher=[[Royal Spanish Football Federation|RFEF]]|date=29 April 2012 |accessdate=29 April 2012|language=Spanish}}</ref>
| highest scoring            = [[FC Barcelona|Barcelona]]&nbsp;8–0&nbsp;[[CA Osasuna|Osasuna]] (17&nbsp;September&nbsp;2011)<br>
[[Real Madrid CF|Real&nbsp;Madrid]]&nbsp;6–2&nbsp;[[Rayo Vallecano|Rayo&nbsp;Vallecano]] (24&nbsp;September&nbsp;2011)<br>
[[Real Madrid CF|Real&nbsp;Madrid]]&nbsp;7–1&nbsp;[[CA Osasuna|Osasuna]] (6&nbsp;November&nbsp;2011)<br/>
[[Sevilla FC|Sevilla]]&nbsp;2–6&nbsp;[[Real Madrid CF|Real&nbsp;Madrid]] (17&nbsp;December&nbsp;2011)<br>
[[Levante UD|Levante]]&nbsp;3–5&nbsp;[[Rayo Vallecano|Rayo&nbsp;Vallecano]] (19&nbsp;February&nbsp;2012)
[[FC Barcelona|Barcelona]]&nbsp;5–3&nbsp;[[Granada CF|Granada]] (20&nbsp;March&nbsp;2012)
| matches                    = 380
| total goals                = 1050
| longest wins               = 11 games by [[Real Madrid CF|Real Madrid]] and [[FC Barcelona|Barcelona]]<ref name="Soccernet">{{cite web|title=Spanish La Liga statistics|url=http://soccernet.espn.go.com/stats/_/league/esp.1/spanish-primera-division?cc=5739|publisher=[[ESPNsoccernet]]|accessdate=29 August 2011}}</ref>
| longest unbeaten           = 23 games by [[Real Madrid CF|Real&nbsp;Madrid]]<ref name=Soccernet/>
| longest winless            = 20 games by [[Racing de Santander|Racing&nbsp;Santander]]<ref name=Soccernet/>
| longest losses             = 6 games by [[Real Betis|Betis]], [[Rayo Vallecano]] and [[Real Zaragoza|Zaragoza]]<ref name=Soccernet/>
| highest attendance         = 99,252<ref>{{cite web|title=Barcelona&nbsp;— Real Madrid, 04/21/2012 |url=http://www.fcbarcelona.com/football/first-team/match-archive/2011-2012/league/round-35/fc-barcelona_real-madrid/info |publisher=fcbarcelona.com|accessdate=22 April 2012}}</ref> [[FC Barcelona|Barcelona]]&nbsp;–&nbsp;[[Real Madrid CF|Real Madrid]]
| lowest attendance          = 6,000<ref name=Soccernet/> [[Getafe CF|Getafe]]&nbsp;–&nbsp;[[Racing de Santander|Racing Santander]]
| attendance                 = 11,504,567<ref name=Soccernet/>
| average attendance         = 30,275<ref name=Soccernet/>
| prevseason                 = [[2010–11 La Liga|2010–11]]
| nextseason                 = [[2012–13 La Liga|2012–13]]
}}
{{clear}}

== References ==
{{Reflist}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Association football infobox templates|Football league season]]
[[Category:Infobox templates with updated parameter]]
}}</includeonly>