View source for Template:Infobox school district/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use}}
{{Lua|Module:Check for unknown parameters}}
{{Uses TemplateStyles}}

== Usage ==
This template is intended for use in [[school district]] articles when there is no more specific template available. 
This should not be used for individual schools. See [[Wikipedia:WikiProject Schools|WikiProject Schools]]' [[Wikipedia:WikiProject Schools/Article guidelines#Infobox|infobox guidelines]] for more detailed guidance on selecting the correct infobox.

=== Full syntax ===
{{Parameter names example
| name
| native_name
| logo
| logo_alt
| logo_size 
| image2 
| image2_alt
| caption2
| address
| location
| region
| city
| state
| province  
| county
| postcode 
| zipcode
| country  
| country1   
| coordinates 
| type  
| motto 
| grades 
| established 
| closed 
| president 
| vice-president 
| superintendent_type
| superintendent 
| deputy_superintendent
| businessadmin 
| school_board 
| chair_of_the_board 
| director_of_education
| governing_agency
| accreditations 
| schools 
| budget  
| us_nces_district_id
| district_id 
| affiliations 
| students 
| faculty  
| teachers  
| staff 
| ratio 
| conference
| sports_nickname
| mascot
| colors 
| schedule 
| website
| module 
}}
''(All parameters, vertical format)''

<code> | name=</code> is the only required parameter, all other fields are optional. Copy and paste the following blank instance to the article page; do not delete fields just because you're unable to find or source the information in the moment, only those that fundamentally do not apply to that particular school system. The empty parameters will not be parsed for display until a value is added, and the empty fields will serve to alert future editors to information that still needs to be researched and included in the article.

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox school district
| name                   = {{subst:PAGENAME}}
| native_name            = 
| logo                   = 
| logo_alt               = 
| logo_size              = 
| image2                 = 
| image2_alt             = 
| caption2               = 
| address                = 
| location               = 
| region                 = 
| city                   = 
| state                  = 
| province               = 
| county                 = 
| postcode               = 
| zipcode                = 
| country                = 
| country1               = 
| coordinates            = <!-- {{Coord|latitude|longitude|type:edu|display=inline,title}} -->
| type                   = 
| motto                  = 
| grades                 = 
| established            = <!-- {{Start date and age|YYYY|MM|DD}} -->
| closed                 = <!-- {{End date|YYYY|MM|DD}} -->
| president              = 
| vice-president         = 
| superintendent_type    = 
| superintendent         = 
| deputy_superintendent  = <!-- or | deputy_superintendents = or | asst_superintendent =  or | asst_superintendents = -->
| businessadmin          = 
| school_board           = 
| chair_of_the_board     = 
| director_of_education  = 
| governing_agency       = 
| accreditations         = <!-- or | accreditation = -->
| schools                = 
| budget                 = 
| us_nces_district_id    = <!-- {{NCES District ID||district_name=|access_date=}} -->
| district_id            = 
| affiliations           = 
| students               = <!-- or | enrollment = -->
| faculty                = 
| teachers               = 
| staff                  = 
| ratio                  = 
| conference             = 
| sports_nickname        = 
| mascot                 = 
| colors                 = <!-- or | colours = -->
| schedule               = 
| website                = <!-- {{URL2|}} -->
| module                 = 
| Board Members          = 
}}</syntaxhighlight>
{{Clear}}

=== Additional free text fields ===
The <code>| free_text''n'' = </code> parameters may be used for additional information not covered by the standard parameters.  These parameters should be used sparingly. 
<syntaxhighlight lang="wikitext">
|free_label          = 
|free_text           = 
|free_label2         = 
|free_text2          = 
|free_label3         = 
|free_text3          = 
|free_label4         = 
|free_text4          = 
</syntaxhighlight>

=== Parameters ===
{{Infobox geolink message}}

{| class="wikitable" style="margin:auto; width:100%;"
! style="text-align: left" | Parameter
! style="text-align: left" | Explanation
|-
! name
| Name of the district. Mandatory.
|-
! logo
| Logo image
|-
! logo 2
| logo 2 image
|-
! motto
| District motto.
|-
|colspan="2" {{rh2}} | Location information 
|-
! address
| Street address of the school district office. Causes the section heading to appear as "Address" instead of "Location"
|-
! location
| Location, could include address; separate lines with {{tag|br|s}}
|-
! region
| Region in which the school district is found.
|-
! city
| City, town or village in which the school district is found.
|-
! state
| State in which the school district is found.
|-
! province
| Province in which the school district is found.
|-
! county
| County or Local Government Area in which the school is found.
|-
! postcode
| The school district office's postcode. '''postalcode''' provides identical results.
|-
! zipcode
| The school district office's zip code.
|-
! country
| Country of the school district (Do not use flag icons and wikilink – see [[WP:OVERLINK]] and [[WP:WPSCH]] for guidance.)
|-
<!--! country1
| Country, in [[ISO 3166-1 alpha-3]] form<br>Useful for stating a semi-autonomous area and the mother country
|AUS, GER, USA  -->
|-
! coordinates
| Geographic coordinates.  Use {{Tl|Coord}} with ''type:edu'' and ''display=inline,title''; for example: ''{{tlx|Coord|dd.dddd|-ddd.dddd|type:edu|display{{=}}inline,title}}.'' If possible, please also include the region information using the correct [[ISO 3166-2]] code. For example: {{tlx|Coord|dd.dddd|-ddd.dddd|type:edu_'''region:US-TN'''|display{{=}}inline,title}} for a district in Tennessee in the United States.
|-
|colspan="2" {{rh2}} | District information
|-
! type
| Type of the district. Public (government funded), private, for profit, non profit, etc.
|-
! grades
| Grade levels served by the district.
|-
! established
| Date of establishment/founding. Use {{Tl|Start date and age}} where possible.
|-
! closed
| Date the district closed.
|-
! superintendent
| Superintendent of the District
|-
! asst_superintendent 
| Assistant Superintendent(s) of the District
|-
! accreditations
| The organization(s), if any, accrediting this district.
|-
! schools
| Summary information about the schools in the district. 
|-
! budget
| District budget, usually expenditure per year.
|-
! us_nces_district_id
| For US districts only, the District ID from the NCES CCD website {{URL2|https://nces.ed.gov/ccd/districtsearch/}}. Also note that {{tl|NCES District ID}} may be useful here.
|-
|colspan="2" {{rh2}} | Students and staff
|-
! students
| Number of the district's students. 
|-
! faculty
| Number of the district's faculty.
|-
! teachers
| Number of the district's teaching staff.
|-
! staff
| Number of staff in the district.
|-
! ratio
| The student:teacher ratio of the district.
|-
! conference
| Athletic conference.
|-
! Nickname
| Sports nickname.
|-
! Mascot
| District mascot.
|-
! Colors
| Official district colors.
|-
|colspan="2" {{rh2}} | Other information 
|-
! free_label
| Use for special requirements
|-
! free_text
| Data for free_label
|-
! free_label2
| rowspan="6" | Use for more special requirements. 
|-
! free_text2
|-
! free_label3
|-
! free_text3
|-
! free_label4
|-
! Board Members
|-
! schedule
| The schedule for the district.
|-
! website
| URL of the district website. Use {{tlx|URL2|district.url}}
|}

== Example ==
{{Infobox school district
|name = Example School District
|logo = Example-serious.jpg
|address = 2548 East Sixth Street
|city = [[Linden, Tennessee]]
|zipcode = 15681
|country = United States
|coordinates = {{Coord|35|36|44|N|87|50|30|W|dim:250_region:US-TN_type:edu|display=inline}}
|motto = ''The District Motto''
|type = Public
|grades = Pre-K through 12
|established = {{Start date|1900|01}}
|closed = {{end date|1950|06|30}}
|superintendent = John Doe, Sr.
|asst_superintendent = John Doe, Junior
|businessadmin = Jane Doe
|school_board= 10 members
|chair_of_the_board = Joseph Doe
|governing_agency = Tennessee Department of Education
|accreditations =[[Southeastern Association]]
|schools = Elementary 12, Middle 4, High 2
|budget = $1.250 million
|us_nces_district_id = {{NCES District ID|0511880|district_name=Nashville School District|access_date=2 November 2012}}
|students = 5,000
|teachers = 500
|staff = 200
|ratio = 10:1
|conference =  [[TSSAA]]
|sports_nickname = [[Saints]]
|mascot = [[Bernie the St. Bernard]]
|colors = Black and Gold
|free_label = [[Beta Club]]
|free_text = Both Junior and Senior
|free_label2 = [[National FFA Organization|FFA]]
|free_text2 = Co-ed
|free_label3 = Release time
|free_text3 = Selected instruction
|free_label4 = State test
|free_text4 = TCAP
|schedule = M-F except state holidays
|website = {{URL2|https://en.wikipedia.org}}
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox school district
|name = Example School District
|logo = Example-serious.jpg
|address = 2548 East Sixth Street
|city = [[Linden, Tennessee]]
|zipcode = 15681
|country = United States
|coordinates = {{Coord|35|36|44|N|87|50|30|W|dim:250_region:US-TN_type:edu|name=Example School District office|display=inline}}
|motto = ''The District Motto''
|type = Public
|grades = Pre-K through 12
|established = {{Start date|1900|01}}
|closed = {{end date|1950|06|30}}
|superintendent = John Doe, Sr.
|asst_superintendent = John Doe, Junior
|businessadmin = Jane Doe
|school_board= 10 members
|chair_of_the_board = Joseph Doe
|governing_agency = Tennessee Department of Education
|accreditations =[[Southeastern Association]]
|schools = Elementary 12, Middle 4, High 2
|budget = $1.250 million
|us_nces_district_id = {{NCES District ID|0511880|district_name=Nashville School District|access_date=2 November 2012}}
|students = 5,000
|teachers = 500
|staff = 200
|ratio = 10:1
|conference =  [[TSSAA]]
|sports_nickname = [[Saints]]
|mascot = [[Bernie the St. Bernard]]
|colors = Black and Gold
|free_label = [[Beta Club]]
|free_text = Both Junior and Senior
|free_label2 = [[National FFA Organization|FFA]]
|free_text2 = Co-ed
|free_label3 = Release time
|free_text3 = Selected instruction
|free_label4 = State test
|free_text4 = TCAP
|schedule = M-F except state holidays
|website = {{URL2|https://en.wikipedia.org}}
}}
</syntaxhighlight>

This '''Example School District''' represents a completely fictional school district.  Data for example locations is arbitrarily selected.

The footnote list is not part of the template:
{{Reflist}}
{{Clear}}

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

== Tracking category ==
* {{Clc|Pages using infobox school district with unsupported parameters}}
* {{Clc|Pages using infobox school district with a misplaced logo caption}}

== TemplateData ==
{{TemplateData header}}
<templatedata>{
	"params": {
		"name": {
			"label": "Official name",
			"description": "Official, legal name of the school district as stated in their bylaws. The default value will automatically copy the article title as the value, set manually if that it not the district's legal name.",
			"example": "Fort Bragg Unified School District",
			"type": "string",
			"default": "{{subst:PAGENAME}}",
			"autovalue": "{{subst:PAGENAME}}",
			"required": true
		},
		"native_name": {
			"description": "The name of the school in the local language",
			"type": "string"
		},
		"logo": {
			"description": "The filename of the school's logo",
			"type": "wiki-file-name"
		},
		"logo_alt": {
			"type": "string"
		},
		"logo_size": {
			"aliases": [
				"logosize"
			],
			"type": "number"
		},
		"logo_caption": {},
		"image": {
			"type": "wiki-file-name"
		},
		"image_alt": {},
		"image_size": {
			"aliases": [
				"imagesize"
			],
			"type": "number"
		},
		"image_caption": {
			"aliases": [
				"caption"
			],
			"type": "string"
		},
		"image2": {
			"type": "wiki-file-name"
		},
		"image2_alt": {},
		"caption2": {
			"type": "string"
		},
		"region": {},
		"country": {},
		"location": {},
		"coordinates": {},
		"address": {
			"aliases": [
				"streetaddress",
				"street"
			],
			"type": "string",
			"description": "The school district's main address",
			"example": "123 Main Street"
		},
		"city": {
			"aliases": [
				"town",
				"city/town"
			],
			"type": "string",
			"description": "The city that the school district is located in",
			"example": "New York City"
		},
		"county": {
			"type": "string"
		},
		"state": {},
		"province": {},
		"postalcode": {
			"aliases": [
				"postcode"
			],
			"type": "string"
		},
		"zipcode": {},
		"country1": {},
		"coordinates_footnotes": {},
		"type": {},
		"grades": {
			"description": "The grade levels taught by the school district",
			"example": "K–12"
		},
		"established": {
			"description": "The date that the school district was established",
			"example": "{{Start date and age|1970|01|01}}"
		},
		"closed": {
			"aliases": [
				"dissolved"
			],
			"type": "date",
			"description": "The date that the school district ceased to exist",
			"example": "{{End date|2020|12|31}}"
		},
		"president": {},
		"vice-president": {},
		"superintendent": {
			"description": "The name of the superintendent of the district"
		},
		"accreditations": {
			"aliases": [
				"accreditation"
			],
			"type": "string"
		},
		"schools": {
			"description": "The number of schools the district manages"
		},
		"budget": {
			"description": "The amount of money the district has in an annual budget"
		},
		"us_nces_district_id": {
			"description": "The NCES ID of the district",
			"example": "{{NCES District ID|1719080|district_name=Twp HSD 113|access_date=2022-03-05}}"
		},
		"motto": {
			"type": "string",
			"label": "Motto",
			"description": "District's official motto; only provide if it is used prominently on primary sources. For district's with multiple mottoes, use the 'mottoes' parameter."
		},
		"superintendent_type": {},
		"deputy_superintendent": {
			"type": "string",
			"label": "Deputy Superintendent",
			"description": "Use for districts with a single deputy, otherwise use deputy_superintendents parameter with {{Unbulleted list}} template."
		},
		"businessadmin": {},
		"school_board": {
			"aliases": [
				"board_of_education"
			],
			"type": "string"
		},
		"chair_of_the_board": {},
		"director_of_education": {},
		"governing_agency": {
			"aliases": [
				"governing agency"
			],
			"type": "string"
		},
		"district_id": {},
		"affiliation": {
			"aliases": [
				"affiliations"
			],
			"type": "string"
		},
		"students": {
			"aliases": [
				"enrollment",
				"enrolment"
			],
			"description": "The number of students enrolled in a given year"
		},
		"faculty": {},
		"teachers": {
			"description": "The number of teachers employed in a given year"
		},
		"staff": {
			"description": "The number of staff employed by the district in a given year"
		},
		"ratio": {
			"description": "The ratio of teachers:students in the district",
			"example": "24:1"
		},
		"conference": {},
		"sports_nickname": {},
		"mascot": {},
		"colors": {
			"aliases": [
				"colours"
			],
			"type": "string"
		},
		"free_label": {
			"aliases": [
				"free_label1"
			],
			"type": "string"
		},
		"free_text": {
			"aliases": [
				"free_text1"
			],
			"type": "string"
		},
		"free_label2": {},
		"free_text2": {},
		"free_label3": {},
		"free_text3": {},
		"free_label4": {},
		"free_text4": {},
		"schedule": {},
		"website": {
			"description": "The official website of the district",
			"example": "{{URL2|https://www.example.com}}"
		},
		"module": {},
		"deputy_superintendents": {
			"label": "Deputy Superintendents",
			"description": "Place each name as an unnamed parameter within the {{Unbulleted list}} template. Use for districts with multiple deputies, otherwise use deputy_superintendent parameter.",
			"example": "{{Unbulleted list|Karen Hickman|Arthur Allen}}",
			"type": "wiki-template-name",
			"default": "{{Unbulleted list|}}"
		},
		"asst_superintendent": {},
		"asst_superintendents": {},
		"mottoes": {
			"label": "Mottoes",
			"description": "District's official mottoes, placed as unnamed parameters within the {{Unbulleted indent list}} template; only provide if they are used prominently on primary sources. For district's a single motto, use the 'motto' parameter.",
			"example": "{{Unbulleted indent list|Motto the first|Motto the second}}",
			"type": "wiki-template-name",
			"default": "{{Unbulleted indent list|}}"
		}
	},
	"paramOrder": [
		"name",
		"native_name",
		"logo",
		"logo_alt",
		"logo_size",
		"logo_caption",
		"image",
		"image_alt",
		"image_size",
		"image_caption",
		"image2",
		"image2_alt",
		"caption2",
		"address",
		"location",
		"region",
		"city",
		"county",
		"state",
		"province",
		"postalcode",
		"zipcode",
		"country",
		"country1",
		"coordinates",
		"coordinates_footnotes",
		"type",
		"motto",
		"mottoes",
		"grades",
		"established",
		"closed",
		"president",
		"vice-president",
		"superintendent_type",
		"superintendent",
		"deputy_superintendent",
		"deputy_superintendents",
		"asst_superintendent",
		"asst_superintendents",
		"businessadmin",
		"school_board",
		"chair_of_the_board",
		"director_of_education",
		"governing_agency",
		"accreditations",
		"schools",
		"budget",
		"us_nces_district_id",
		"district_id",
		"affiliation",
		"students",
		"faculty",
		"teachers",
		"staff",
		"ratio",
		"conference",
		"sports_nickname",
		"mascot",
		"colors",
		"free_label",
		"free_text",
		"free_label2",
		"free_text2",
		"free_label3",
		"free_text3",
		"free_label4",
		"free_text4",
		"schedule",
		"website",
		"module"
	],
	"format": "{{_\n | ______________________ = _\n}}",
	"description": "Displays a standardized table of important data points at the top-right corner of school district articles"
}</templatedata>

== See also ==
* {{Tl|Infobox school}}
* [[:Category:Education infobox templates|Education infobox templates]]
* [[:Category:WikiProject Schools templates|WikiProject Schools templates]]

{{Organization infoboxes}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Education infobox templates|School district]]
[[Category:Infobox templates with module parameter|School district]]
[[Category:Templates that add a tracking category]]
}}</includeonly>