View source for Template:Infobox university/doc

{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{High-use|23924}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Location map|Module:Check for unknown parameters}}

{{Generic template demo
 |name |native_name <!--|native_name_lang--> |image |image_size |image_alt |caption
 |latin_name |other_name={{{other_name}}} ''or''&nbsp;{{{other_names}}} |former_name={{{former_name}}} ''or''&nbsp;{{{former_names}}}
 |motto <!--|motto_lang--> |mottoeng|type|established={{{established}}}<br/>[{{thinsp}}–{{{closed}}}{{thinsp}}] <!--|closed-->|founder={{{founder}}} or {{{founders}}}
 |parent |affiliation |religious_affiliation |academic_affiliation |endowment |budget
 |officer_in_charge |chairman |chairperson |chancellor |president |vice-president |superintendent |vice_chancellor |provost |rector |principal
 |dean |director |head_label|head |academic_staff |administrative_staff |students |enrollment |undergrad |postgrad |doctoral |other_students
 |location={{{location}}}<br/>{{nowrap|''or'' {{{address}}} ''(optional)''<br/>{{{city}}}, {{{state}}},<br/>{{{province}}},<br/>{{{postalcode}}} ''or''<br/> {{{zipcode}}} ''(optional)''<br/>{{{country}}}}} |coordinates |campus |language |free_label|free
 |colors={{{colors}}} ''or''&nbsp;{{{colours}}} |athletics |sports |nickname={{{sports_nickname}}} |mascot={{{mascot}}} ''or''&nbsp;{{{mascots}}}
 |sporting_affiliations |website |logo |nrhp={{{nrhp}}} ''or''&nbsp;{{{embedded}}}
 <!--|pushpin_map |pushpin_label_position |map_size |pushpin_map_caption |latitude |latm |latd |latNS |longitude |longm |longd |longEW-->
 |footnotes = {{{pushpin_map}}}<br/>{{{footnotes}}}
}}

{{tl|Infobox university}} is an [[Help:Infobox|infobox]] for articles about universities and colleges; see [[Wikipedia:College and university article guidelines]].

== Blank syntax ==

All fields other than <code>name</code>, <code>established</code> and <code>city</code> are optional. The parameter keywords, as below, '''''must''''' be in [[lower case]].
<pre style="overflow:auto">
{{Infobox university
| name              = 
| native_name       = 
| native_name_lang  = 
| image             = 
| image_upright     = 
| image_alt         = 
| caption           = 
| latin_name        = 
| other_name        = <!--or, other_names-->
| former_name       = <!--or, former_names-->
| motto             = 
| motto_lang        = 
| mottoeng          = 
| top_free_label    = 
| top_free          = 
| type              = 
| established       = <!-- {{start date|YYYY}} -->
| closed            = <!-- {{end date|YYYY}} -->
| founder           = 
| parent            = 
| affiliation       = 
| religious_affiliation = 
| academic_affiliation  = 
| endowment         = 
| budget            = 
| officer_in_charge = 
| chairman          = 
| chairperson       = 
| chancellor        = 
| president         = 
| vice-president    = 
| superintendent    = 
| vice_chancellor   = 
| provost           = 
| rector            = 
| principal         = 
| dean              = 
| director          = 
| head_label        = 
| head              = 
| academic_staff    = 
| administrative_staff = 
| students          = 
| undergrad         = 
| postgrad          = 
| doctoral          = 
| other             = 
| address           = <!-- Please discuss before using -->
| city              = 
| state             = 
| province          = 
| country           = 
| postcode          = <!--or, postalcode or zipcode-->
| coordinates       = <!-- {{Coord}} -->
| campus            = 
| language          = 
| free_label        = 
| free              = 
| free_label2       = 
| free2             = 
| colors            = <!--or, colours= -->
| athletics         = 
| sports            = 
| athletics_nickname = <!--or,  sports_nickname= -->
| sporting_affiliations = 
| mascot            = <!--or, mascots= -->
| sports_free_label = 
| sports_free       = 
| sports_free_label2 = 
| sports_free2      = 
| website           = <!-- {{URL|example.com}} -->
| logo              = 
| logo_size         = 
| logo_alt          = 
| footnotes         = 
}}
</pre>
{{clear}}

== Example ==

{{Infobox university
| name = University of Illyria
| native_name = Universiti von Illyria
| native_name_lang = de
| other_name = UI
| image = Dabney-minimalist-vector.svg
| image_upright = 0.7
| image_alt = scroll atop shield outline
| caption = Seal of University of Illyria
| latin_name = Universitas Illyriensis
| former_name = Utopian University
| motto = ''Melior a lepidus fossor quam a stultus lepor lepos''
| motto_lang = la
| mottoeng = "Better a witty fool than a foolish wit"
| established = {{start date|1666}}
| closed = {{end date|1850}}
| type = [[Public university|Public]]
| affiliation = Church of Illyria
| endowment = [[US$]]&nbsp;123,456,789
| officer_in_charge = | chairman = 
| chancellor = [[Jane Doe]]
| president = | vice-president = | superintendent = 
| vice_chancellor = | provost = | rector = | principal = | dean = | director = 
| head_label = [[Visitor]]
| head = [[John Doe|Archbishop Doe]]
| academic_staff = 300
| administrative_staff = 600
| students = 10,000
| undergrad = 5,000
| postgrad = 1,000
| doctoral = 100
| other_students = 1,200{{sup|a}}
| city = [[Illyria]]
| state = [[Illyria]]
| province = 
| country = [[Utopia]]
| coordinates = {{coord|12.34|-98.76|type:edu|display=inline}}
| campus = [[Rural area|Rural]]
| language = 
| colours = {{color box|red}}{{color box|blue}} Red and Blue
| athletics = 
| sports = {{hlist |[[Track and field|Track]] |[[Water polo]]}}
| sports_nickname = The Nematodes
| mascot = Nobby the Nematode
| sporting_affiliations = [[Utopian Athletic League]]
| website = {{URL|www.illyria.edu}}
| logo = EUSP logo lowres.jpg
| logo_size = 50px
| logo_alt = Spiral on stripes
| footnotes = <hr/>
<div style="text-align:left;">
{{sup|a}} [[Further education]].<br/>
</div>
Note: This university is completely fictional.
}}
<pre style="overflow:auto;">
{{Infobox university
| name = University of Illyria
| native_name = Universiti von Illyria
| native_name_lang = de
| other_name = UI
| image = Dabney-minimalist-vector.svg
| image_upright = 0.7
| image_alt = scroll atop shield outline
| caption = Seal of University of Illyria
| latin_name = Universitas Illyriensis
| former_name = Utopian University
| motto = ''Melior a lepidus fossor quam a stultus lepor lepos''
| motto_lang = la
| mottoeng = "Better a witty fool than a foolish wit"
| established = {{start date|1666}}
| closed = {{end date|1850}}
| type = [[Public university|Public]]
| affiliation = Church of Illyria
| endowment = [[US$]]&nbsp;123,456,789
| officer_in_charge = | chairman = 
| chancellor = [[Jane Doe]]
| president = | vice-president = | superintendent = 
| vice_chancellor = | provost = | rector = | principal = | dean = | director = 
| head_label = [[Visitor]]
| head = [[John Doe|Archbishop Doe]]
| academic_staff = 300
| administrative_staff = 600
| students = 10,000
| undergrad = 5,000
| postgrad = 1,000
| doctoral = 100
| other_students = 1,200{{sup|a}}
| city = [[Illyria]]
| state = [[Illyria]]
| province = 
| country = [[Utopia]]
| coordinates = {{coord|12.34|-98.76
    |type:edu
    |display=inline}}
| campus = [[Rural area|Rural]]
| language = 
| colours = {{color box|red}}{{color box|blue}} Red and Blue
| athletics = 
| sports = {{hlist |[[Track and field|Track]] |[[Water polo]]}}
| sports_nickname = The Nematodes
| mascot = Nobby the Nematode
| sporting_affiliations = [[Utopian Athletic League]]
| website = {{URL|www.illyria.edu}}
| logo = EUSP logo lowres.jpg
| logo_size = 50px
| logo_alt = Spiral on stripes
| footnotes = <hr/>
<div style="text-align:left;">
{{sup|a}} [[Further education]].<br/>
</div>
Note: This university is completely fictional.
}}
</pre>
{{clear}}

== Microformat ==
{{UF-hcard-org}}

== Parameter descriptions ==

{{Format TemplateData|JSON=
{
	"description": "An infobox for articles about universities and colleges.",
	"params": {
		"name": {
			"required": true,
			"type": "line",
			"label": "Name (in English)",
			"description": "Official name in English."
		},
		"native_name": {
			"type": "line",
			"label": "Native Name",
			"description": "Name in its native language."
		},
		"native_name_lang": {
			"type": "string",
			"label": "Native Name Language",
			"description": "ISO 639-2 code e.g. 'fr' for French."
		},
        "other_name": {
            "type": "line",
            "aliases": ["other_names"],
            "label": "Current alternative names",
            "description": "For any alternative ''current'' names by which the university is known, such as acronyms and abbreviations."
        },
        "former_name": {
            "type": "line",
            "aliases": ["former_names"],
            "label": "Former names",
            "description": "Any former name or names of the institution."
        },
		"image": {
			"type": "wiki-file-name",
			"label": "Image Name",
			"description": "University-related graphic, preferably the university's official seal or logo. Use the image filename without File: namespace prefix. Sizes the image to the user's preference by default (200px for readers who aren't logged in).",
			"aliases": [
				"image_name"
			]
		},
        "image_upright": {
           "type": "number",
           "label": "Image scaling (\"upright\")",
          "description": "Scaling factor for the image, such as 0.7. The actual size is the scaling factor multiplied by the user's thumbnail size.",
           "example": "0.7"
        },
		"image_size": {
			"type": "string",
			"label": "Image Size",
			"description": "Use in conjunction with image. Allows editors to specify an image width rather than use the default.",
            "example": "120px"
		},
		"image_alt": {
			"type": "string",
			"label": "Alternative Text for Image",
			"description": "Alt text for image, for visually impaired readers. This should not contain wiki syntax, and should not duplicate the caption. See [[WP:ALT]]."
		},
		"caption": {
			"type": "content",
			"label": "Caption",
			"description": "Caption text for the infobox image. May include wiki syntax."
		},
		"latin_name": {
			"type": "line",
			"label": "Latin Name",
			"description": "University name in Latin."
		},
		"motto": {
			"type": "string",
			"label": "Motto",
			"description": "University's motto; usually in Latin."
		},
		"motto_lang": {
			"type": "string",
			"label": "Motto Language",
			"description": "If the motto is not in English, the ISO 639-2 code for its language (e.g. \"fr\" for French). If more than one, use {{tl|lang}} instead."
		},
		"mottoeng": {
			"type": "string",
			"label": "Motto (in English)",
			"description": "University's motto in English if another language is used above."
		},
		"top_free_label": {
		  "type": "line",
		  "label": "Top free label",
		  "description": "First custom special label of upper infobox. The data for this field goes in parameter top_free."
		},
		"top_free": {
		  "type": "string",
		  "label": "Top free",
		  "description": "First custom data field of upper infobox. The name of this field goes in parameter top_free_label."
		},
		"top_free_label1": {
		  "type": "line",
		  "label": "Top free label1",
		  "description": "Next custom special label1 of upper infobox. The data for this field goes in parameter top_free1."
		},
		"top_free1": {
		  "type": "string",
		  "label": "Top free1 data",
		  "description": "Next custom data1 field of upper infobox. The name of this field goes in parameter top_free_label1."
		},
		"top_free_label2": {
		  "type": "line",
		  "label": "Top free label2",
		  "description": "Next custom label2 of upper infobox. The data for this field goes in parameter top_free2."
		},
		"top_free2": {
		  "type": "string",
		  "label": "Top free2 data",
		  "description": "Next custom data2 field of upper infobox. The name of this field goes in parameter top_free_label2."
		},
		"established": {
			"required": true,
			"type": "line",
			"label": "Year Established",
			"description": "Date of establishment/founding. Give year if no exact date is available. Use the template {{tl|Start date}}."
		},
		"closed": {
			"type": "line",
			"description": "For former universities, provide the date of closure. Give year if no exact date is available. Use the template {{tl|End date}}."
		},
		"type": {
			"type": "line",
			"description": "Public, private, four year, undergraduate, graduate, etc."
		},
		"parent": {
			"type": "line",
			"label": "Parent institution",
			"description": "Name of any parent institution (e.g. for some colleges, a university)."
		},
		"affiliation": {
			"type": "line",
			"label": "Affiliation",
			"description": "The institute's affiliation (if not specifically religious or academic)."
		},
		"religious_affiliation": {
			"type": "line",
			"label": "Affiliation",
			"description": "Use if the institution has a religious affiliation."
		},
		"academic_affiliation": {
			"type": "line",
			"label": "academic affiliation",
			"description": "Use if the institution has an academic affiliation.",
            "aliases": ["academic_affiliations"]
		},
		"endowment": {
			"type": "line",
			"label": "Endowment",
			"description": "[[Financial endowment]] value."
		},
		"budget": {
			"type": "line",
			"label": "Budget",
			"description": "Total budget / income."
		},
		"rector": {
			"type": "line",
			"label": "Rector",
			"description": "Rector of the institution."
		},
		"officer_in_charge": {
			"type": "line",
			"label": "Officer in Charge",
			"description": "Officer in Charge of the institution."
		},
		"chairman": {
			"type": "line",
			"label": "Chairman",
			"description": "Chairman of the institution."
		},
		"chairperson": {
			"type": "line",
			"label": "Chairperson",
			"description": "Chairperson of the institution."
		},
		"chancellor": {
			"type": "line",
			"label": "Chancellor",
			"description": "Chancellor of the institution."
		},
		"president": {
			"type": "line",
			"label": "President",
			"description": "President of the institution."
		},
		"vice-president": {
			"type": "line",
			"label": "Vice President",
			"description": "Vice President of the institution."
		},
		"superintendent": {
			"type": "line",
			"label": "Superintendent",
			"description": "Superintendent of the institution."
		},
		"vice_chancellor": {
			"type": "line",
			"label": "Vice Chancellor",
			"description": "Vice Chancellor of the institution."
		},
		"provost": {
			"type": "line",
			"label": "Provost",
			"description": "Provost of the institution."
		},
		"principal": {
			"type": "line",
			"label": "Principal",
			"description": "Principal of the institution."
		},
		"dean": {
			"type": "line",
			"label": "Dean",
			"description": "Dean of the institution."
		},
		"director": {
			"type": "line",
			"label": "Director",
			"description": "Director of the institution."
		},
		"head_label": {
			"type": "line",
			"label": "Head Label",
			"description": "Another officer title. Use with the Head Name field."
		},
		"head": {
			"type": "line",
			"label": "Head Name",
			"description": "The name of the officer that goes with the Head Label."
		},
		"academic_staff": {
			"type": "line",
			"label": "# of Academic Staff",
			"description": "Number of [[Faculty (academic staff)|faculty]] / academic staff members. (include number formatting e.g. 1,234,567,890)"
		},
		"administrative_staff": {
			"type": "line",
			"label": "# of Administrative Staff",
			"description": "Number of administrative / support staff. (include number formatting e.g. 1,234,567,890)"
		},
		"students": {
			"type": "line",
			"label": "# of Students",
			"description": "Total student count. Use undergrad, postgrad, doctoral and other for additional detail. (format amount, as 1,234,567,890 instead of 1234567890)"
		},
		"undergrad": {
			"type": "line",
			"label": "# of Undergrads",
			"description": "Total undergraduate enrollment. (include number formatting e.g. 1,234,567,890 instead of 1234567890)"
		},
		"postgrad": {
			"type": "line",
			"label": "# of Postgrads",
			"description": "Total postgraduate enrollment. (include number formatting e.g. 1,234,567,890 instead of 1234567890)"
		},
		"doctoral": {
			"type": "line",
			"label": "# of Doctorals",
			"description": "Total doctoral enrollment. (include number formatting e.g. 1,234,567,890 instead of 1234567890)"
		},
		"other": {
			"type": "string",
			"label": "Other enrollment",
			"description": "Other student enrollment. Specify a category if possible. (include number formatting e.g. 1,234,567,890 instead of 1234567890)"
		},
		"address": {
			"required": false,
			"type": "line",
			"label": "Address",
			"description": "Street address the university is located in. Please consider a discussion on the talk page before using this field. In many cases, public institutions have more than one campus, and a full address is not representative."
		},
		"city": {
			"required": true,
			"type": "line",
			"label": "City",
			"description": "City the university is located in. Provide wikilink if possible."
		},
		"state": {
			"type": "line",
			"label": "State",
			"description": "U.S. state or similar administrative subdivision. Use in conjunction with the Country field, and do not use with the Province field. Provide wikilink if possible."
		},
		"province": {
			"type": "line",
			"label": "Province",
			"description": "For all other administrative subdivisions; use as an alternative to the State field in conjunction with the Country field."
		},
		"postalcode": {
			"required": false,
			"aliases": [
				"postcode", "zipcode"
			],
			"type": "string",
			"label": "Postal code",
			"description": "Postal code for the university. Please consider a discussion on the talk page before using this field. In many cases, public institutions have more than one campus, and a postal code may not be representative."
		},
		"country": {
			"type": "line",
			"label": "Country",
			"description": "Country in which the university is based. Use in conjunction with city and, optionally, state or province. Provide wikilink if possible."
		},
		"coordinates": {
			"type": "line",
			"label": "Coordinates",
			"description": "Displays coordinates, in parentheses, after the location fields. Use the template {{tl|Coord}} with type:edu and display=inline,title.",
			"aliases": ["coor"]
		},
		"campus": {
			"type": "line",
			"label": "Campus type",
			"description": "Type/nature of the institution's campus (e.g. urban, rural, multiple sites)."
		},
		"former_names": {
			"type": "line",
			"label": "Former Names",
			"description": "Previous names the university was known by."
		},
		"language": {
			"type": "line",
			"label": "Instruction Language",
			"description": "Language commonly used for instruction"
		},
		"free_label": {
		  "type": "line",
		  "label": "Free label",
		  "description": "A special field title; use with the Free data field."
		},
		"free": {
		  "type": "line",
		  "label": "Free data",
		  "description": "Related data that goes with the Free label field."
		},
		"free_label1": {
		  "type": "line",
		  "label": "Free label 1",
		  "description": "Next middle custom specialty field label; labels the free data 1 field."
		},
		"free1": {
		  "type": "string",
		  "label": "Free data 1",
		  "description": "Data by Free label 1 field."
		},
		"free_label2": {
		  "type": "line",
		  "label": "Free label 2",
		  "description": "Next middle custom specialty field label."
		},
		"free2": {
		  "type": "string",
		  "label": "Free data2",
		  "description": "Data by Free Label2 field."
		},
		"athletics": {
			"type": "string",
			"label": "Athletics",
			"description": "Primary university sports. Use Athletics or Sports, whichever is appropriate."
		},
		"colours": {
			"aliases": [
				"colors"
			],
			"type": "string",
			"label": "Official colo(u)rs",
			"description": "Official university colors. Your choice of parameter name (color or colour) will appear in the table; use the one appropriate to the university's location."
		},
		"sports": {
			"type": "string",
            "aliases": ["athletics"],
			"label": "Sports",
			"description": "Primary university sports. Use Athletics or Sports, whichever is appropriate."
		},
		"nickname": {
			"type": "string",
            "aliases": ["athletics_nicknames", "sports_nicknames", "athletics_nickname", "sports_nickname"],
			"label": "Athletic nickname",
			"description": "University's athletic nickname or moniker."
		},
		"mascot": {
			"type": "string",
            "aliases": ["mascots"],
			"label": "Mascot",
			"description": "University's athletic mascot."
		},
		"sporting_affiliations": {
			"type": "string",
			"label": "Sporting Affiliations",
			"description": "List of sporting affiliations and memberships. Provide wikilink if possible; (use {{tl|plainlist}} or {{tl|ublist}})."
		},
		"sports_free_label": {
		  "type": "line",
		  "label": "Sports Free label",
		  "description": "First custom field label title near bottom of infobox; use with Sports-Free field."
		},
		"sports_free": {
		  "type": "string",
		  "label": "Sports Free data",
		  "description": "First bottom custom data field; use with Sports Free label field."
		},
		"sports_free_label1": {
		  "type": "line",
		  "label": "Sports Free1 label",
		  "description": "Next bottom custom label; use with Sports-Free1 field."
		},
		"sports_free1": {
		  "type": "string",
		  "label": "Sports Free1 data",
		  "description": "Next bottom custom data field; use with Sports Free1 label."
		},
		"sports_free_label2": {
		  "type": "line",
		  "label": "Sports Free2 label",
		  "description": "Next bottom custom label; use with Sports-Free2 field."
		},
		"sports_free2": {
		  "type": "string",
		  "label": "Sports Free2 data",
		  "description": "Next custom data field; use with Sports Free2 label."
		},
		"sports_free_label3": {
		  "type": "line",
		  "label": "Sports Free3 label",
		  "description": "Next bottom custom label; use with Sports-Free3 field."
		},
		"sports_free3": {
		  "type": "string",
		  "label": "Sports Free3 data",
		  "description": "Next custom data field; use with Sports Free3 label."
		},
		"website": {
			"type": "line",
			"label": "Website",
			"description": "Official university website. Use the template {{tl|URL}}."
		},
		"logo": {
			"type": "wiki-file-name",
			"label": "Logo",
			"description": "Use for an athletics logo, corporate emblem, or similar graphic. Omit \"File:\""
		},
		"footnotes": {
			"type": "string",
			"label": "Footnotes",
			"description": "Footnotes for the infobox. Useful for including references for data."
		}
	},
	"format": "block",
	"paramOrder": [
		"name",
		"native_name",
		"native_name_lang",
        "other_name",
        "former_name",
		"image",
        "image_upright",
		"image_size",
		"image_alt",
		"caption",
		"latin_name",
		"motto",
		"motto_lang",
		"mottoeng",
		"top_free_label",
		"top_free",
		"top_free_label1",
		"top_free1",
		"top_free_label2",
		"top_free2",
		"established",
		"closed",
		"type",
		"parent",
		"affiliation",
        "religious_affiliation",
		"academic_affiliation",
		"endowment",
		"budget",
		"rector",
		"officer_in_charge",
		"chairman",
		"chairperson",
		"chancellor",
		"president",
		"vice-president",
		"superintendent",
		"vice_chancellor",
		"provost",
		"principal",
		"dean",
		"director",
		"head_label",
		"head",
		"academic_staff",
		"administrative_staff",
		"students",
		"undergrad",
		"postgrad",
		"doctoral",
		"other",
		"address",
		"city",
		"state",
		"province",
		"postalcode",
		"country",
		"coordinates",
		"campus",
		"former_names",
		"language",
		"free_label",
		"free",
		"free_label1",
		"free1",
		"free_label2",
		"free2",
		"athletics",
		"colours",
		"sports",
		"nickname",
		"mascot",
		"sporting_affiliations",
		"sports_free_label",
		"sports_free",
		"sports_free_label1",
		"sports_free1",
		"sports_free_label2",
		"sports_free2",
		"sports_free_label3",
		"sports_free3",
		"website",
		"logo",
		"footnotes"
	]
}
}}

=== Custom blank/free parameters ===
Note how the 10 customized free-data parameters (or blank label/data pairs) are shown in 3 parts of the infobox as upper/middle/bottom: upper (as "top_free_label=" with "top_free=" to "top_free2"), or middle (as "free_label=" with "free=" to "free2") or bottom (as "sports_free_label=" with "sports_free=" to "sports_free3"). Those 10 custom parameters allow speciality field labels and data values for 10 extra parameter label/data pairs. Also any of those 10 custom fields could be mere note labels, with text, to briefly explain nearby parameters, or link footnotes, without cluttering the other label/data pairs. A custom label can be set blank to hide as with "free_label=&amp;nbsp;" to show only the data portion, with hidden label.

== Tracking categories ==
* {{clc|Instances of Infobox university using both image and image name}}
* {{clc|Instances of Infobox university using image_size}}
* {{clc|TEMP - Infobox university with a superintendent parameter value}}
* {{clc|Pages using infobox university with unknown parameters}}

{{Organization infoboxes}}

<includeonly>
{{#ifeq:{{SUBPAGENAME}}|sandbox2 |
| <!--Categories below here, please; interwikis to Wikidata.-->
<!--Eponymous categories:-->
[[Category:Universities and colleges infobox templates| ]]
<!--Other categories:-->
[[Category:Organization infobox templates|University]]
[[Category:Templates that add a tracking category]]
[[Category:Templates with coordinates fields]]
[[Category:WikiProject Universities templates]]
}}</includeonly>