Template:Infobox military conflict/doc

Usage

Battle of Lützen
Part of the Thirty Years' War
Battle of Lutzen The Battle of Lützen by Carl Wahlbom shows the death of King Gustavus Adolphus on 16 November 1632.
Date 6 November (O.S.) or 16 November (N.S.), 1632 Location Near Lützen, southwest of Leipzig (present-day Germany) Result Swedish Pyrrhic victory
Belligerents
Sweden Protestant Union	Holy Roman Empire File:Catholic League (Germany).svg Catholic League
Commanders and leaders
Gustavus Adolphus † Dodo von Knyphausen Bernhard of Saxe-Weimar Robert Munro, 18th Baron of Foulis	Albrecht von Wallenstein Heinrich Holk Count Gottfried zu Pappenheim (DOW)
Strength
12,800 infantry 6,200 cavalry 60 guns	10,000 infantry 7,000 cavalry, plus 3,000 infantry and 2,000 cavalry on arrival 24 guns
Casualties and losses
3,400 dead and 1,600 wounded or missing	Probably about the same as Swedish casualties

A military conflict infobox (sometimes referred to as a warbox) may be used to summarize information about a particular military conflict (a battle, campaign, war, or group of related wars) in a standard manner.

The infobox should be added using the {{infobox military conflict}} template, as shown below:

{{Infobox military conflict
| conflict    = 
| width       = 
| partof      = 
| image       = 
| caption     = 
| date        = 
| place       = 
| coordinates = 
| map_type    = 
| map_relief  = 
| latitude    = 
| longitude   = 
| map_size    = 
| map_marksize = 
| map_caption = 
| map_label   = 
| territory   = 
| result      = 
| status      = 
| combatants_header = 
| combatant1  = 
| combatant2  = 
| combatant3  = 
| commander1  = 
| commander2  = 
| commander3  = 
| units1      = 
| units2      = 
| units3      = 
| strength1   = 
| strength2   = 
| strength3   = 
| casualties1 = 
| casualties2 = 
| casualties3 = 
| notes       = 
| campaignbox = 
}}

Note: When using parameters, avoid the ambiguous abbreviation "N/A", and instead use "unknown" or "none". All subjective or qualitative judgements and numerical quantities or statistics must be cited to a reliable source (see WP:MILMOS#CITE).

Parameters

• conflict – the name of the conflict being described (e.g. "Battle of Lützen" or "World War I").
• width - optional - the width of the infobox, e.g. "400px"; defaults to: "315px".
• partof – optional – the larger conflict containing the event described in the article. For battles or campaigns, this should be the war during which the event takes place; for particularly large wars, this may include a theatre (e.g. "the Eastern Front of World War II"). For wars, the parameter may be used to link to a larger group of wars (e.g. the Italian War of 1521–26 to the Italian Wars). It may be necessary to insert "the" before the name of the war for proper grammar.
• image – optional – an image for the warbox. The image must be given in the form [[File:Example.jpg|300px|alt=Example alt text]]; in particular, the thumb attribute must not be selected.
• image_size – optional – a size for the image.
• caption – optional – the text to be placed below the image.
• date – optional – the date of the conflict described. Convention is to give the actual date for battles and the years for wars, but this does not always apply.
• place – the location of the conflict. For conflicts covering a wide area, a general description (e.g. "France", or "Europe", or "Worldwide") may be used.
• coordinates – optional – the location of the structure, given as a coordinate pair by using {{coord}} with display=inline,title.
• map_type – optional – the base map to be used for the location map, e.g. "Scotland"; see {{location map}} for more details.
• map_relief – optional – "yes" if the location map is a relief map; see {{location map}} for more details.
• latitude – optional – latitude for placing the marker on the location map, e.g. "56.81".
• longitude – optional – longitude for placing the marker on the location map, e.g. "-2.68".
• map_size – optional – width of the location map in pixels (px), e.g. "150"; defaults to: "220".
• map_mark – optional – the name of a file to use as the location map marker, e.g. Green_pog.svg; defaults to: "Red_pog.svg".
• map_marksize – optional – width of the location map marker in pixels (px), e.g. "10"; defaults to: "8".
• map_caption – optional – caption displayed below the location map; defaults to "Location within {{{map_type}}}", e.g. "Location within Scotland".
• map_label – optional – the label placed next to the marker on the location map.
• territory – optional – any changes in territorial control as a result of the conflict; this should not be used for overly lengthy descriptions of the peace settlement.
• action – optional – In case of Coup d'État, short description of modus operandi, e.g. "...marched over the city...", "...dissolving the Congress of the Republic...", "...take the government hostage ...", "...put the country under military control ...", etc.
• result – optional – this parameter may use one of several standard terms: "X victory", "Decisive X victory" or "Inconclusive". The choice of term should reflect what the sources say. In cases where the standard terms do not accurately describe the outcome, a link to the section of the article where the result is discussed in detail (such as "See the 'Aftermath' section") should be used instead of introducing non-standard terms like "marginal" or "tactical" or contradictory statements like "decisive tactical victory but strategic defeat". It is better to omit this parameter altogether than to engage in speculation about which side won or by how much.
• status – optional – for ongoing conflicts, the current status of the conflict. This should not be used if a final result (above) is provided.
• combatants_header – optional – sets the header text for the combatants section. Default is "Belligerents". In case of Coup d'État, use "Government-Insurgents   "
• combatant1/combatant2/combatant3 – optional – the parties participating in the conflict. This is most commonly the countries whose forces took part in the conflict; however, larger groups (such as alliances or international organizations) or smaller ones (such as particular units, formations, or groups) may be indicated if doing so improves reader understanding. When there is a large number of participants, it may be better to list only the three or four major groups on each side of the conflict, and to describe the rest in the body of the article. The combatant3 field may be used if a conflict has three distinct "sides", and should be left blank on other articles. Combatants should be listed in order of importance to the conflict, be it in terms of military contribution, political clout, or a recognized chain of command. If differing metrics can support alternative lists, then ordering is left to the editors of the particular article.
  • combatant1a/combatant2a/combatant3a – optional – in cases where the parties significantly changed over the course of the conflict, these subsidiary fields may be used to provide additional rows for the combatantN fields (above).
  • combatant1b/combatant2b/combatant3b – optional – additional row, as above.
  • combatant1c/combatant2c/combatant3c – optional – additional row, as above.
  • combatant1d/combatant2d/combatant3d – optional – additional row, as above.
• commander1/commander2/commander3 – optional – the commanders of the military forces involved. For battles, this should include military commanders (and other officers as necessary). For wars, only prominent or notable leaders should be listed, with an upper limit of about seven per combatant column recommended. Ranks and position titles should be omitted. The {{KIA}} and {{POW}} templates may be included immediately after the names of commanders who were killed in action or surrendered and were taken prisoner, respectively. The commander3 field can only be used if the combatant3 field is set.
• units1/units2/units3 – optional – the units or formations involved. If a large number of distinct formations is present, it may be better to reference an order of battle in the body of the article than to include the entire list in this field. The units3 field can only be used if the combatant3 field is set.
• strength1/strength2 – optional – the numerical strength of the units involved.

• polstrength1/polstrength2 – optional – In case of Coup d'Etat, political organizations that supported the government (1) respective the insurgents (2).
• milstrength1/milstrength2 – optional – In case of Coup d'Etat, military units that supported the government (1) respective the insurgents (2).

• strength3 – optional – if combatant3 is set, this is a third strength field identical to the two above; if it is not set, this is an alternate combined field for use where only the total participation in a conflict is known.
• casualties1/casualties2 – optional – casualties suffered, including dead, wounded, missing, captured, and civilian deaths. Terms such as "dead" (or "killed"), "wounded", or "captured" should be used in place of abbreviations such as "KIA" or "POW".
• casualties3 – optional – if combatant3 is set, this is a third casualty field identical to the two above; if it is not set, this is an alternate combined field for use where only the total casualties of a conflict are known, or where civilian casualties cannot be directly attributed to either side.
• notes – optional – optional field for further notes; this should only be used in exceptional circumstances.
• campaignbox – optional – optional field for appending a campaignbox template to the bottom of the infobox, which allows both boxes to float as a single element (useful if there are subsequent left floating images, which would otherwise not be able to float above the campaign box); the template must be specified in the format {{Campaignbox XYZ}}.

Campaignboxes

One common type of navigational template in articles concerning conflicts, wars and related topics is the campaignbox template, intended to provide context and convenient navigation among articles on the battles in a campaign, front, theater or war (or, more rarely, among several campaigns or wars).

If the article includes an infobox, the campaignbox/es are usually placed immediately after it (i.e. just below it). If available, as with infoboxes such as {{Infobox military conflict}}, use the infobox's |campaignbox= parameter:

{{Infobox military conflict
...
}}
{{Campaignbox XXXX}}

or

{{Infobox military conflict
...
| campaignbox = {{campaignbox XXXX}}
}}

Articles may include multiple campaignboxes; typically, these are stacked under the infobox. The most common scenario occurs when two levels of campaignboxes are present – for example, an article about a battle can include both a campaignbox listing the battle itself and an "enclosing" campaignbox listing the campaign, theater or war during which the battle took place. Similarly, an article about a war can include both a campaignbox listing the war (among a series of wars) and a campaignbox for the war itself, listing the battles that took place during it.

Creating campaignboxes

---

Existing campaignboxes may be viewed through the Campaignbox template category to which campaignboxes are added automatically. If a new campaignbox becomes necessary, it should be named Template:Campaignbox XXXX (where XXXX is the (shortened) name of the campaign) and should use {{Campaignbox}} thus:

{{Campaignbox
| name = 
| title = 
| battles = 
| notes = 
}}

Parameters

name

The name by which Wikipedia refers to the template, i.e. "Template:Campaignbox XXXX". This can be produced by using {{subst:PAGENAME}}.

title

The name of the campaign or war, which, if an article about the campaign or war exists, should link to it. Dates should not be indicated unless needed for clarity. Note that long links may cause alignment problems; see the troubleshooting guide for more information.

battles

A chronological list of battles and operations in the campaign, linked as [[Battle of YYYY|YYYY]]. A convenient and accessible way to separate the items in the list is to add | listclass = hlist and then use the standard * (asterisk)-based listing format.

notes

(optional) Any explanatory notes needed to clarify the list. This option should be used sparingly.

(raw_name)

(optional; deprecated) This parameter overrides the use of the title in determining the template name and exists for the sake of backward compatibility. When creating a new campaignbox, both title and name should be specified as above and this parameter omitted.

The following optional parameters are passed on to the templates {{Military navigation}} or {{Navbox}} used to create campaignboxes and so can affect their styling. See these two templates' documentation pages for further details.

state

To set whether the campaignbox appears fully visible or collapsed (to titlebar only) when it is first presented by a page.

bodyclass

CSS styling to affect the whole template.

listclass

CSS styling to affect the list of battles, operations, etc. (e.g. to affect |battles=).

The use of special formatting (such as bolding or changes in font size) in the list of battles – particularly to mark battles as "important" – is generally discouraged; while there are a few cases where such approaches may be both helpful to the reader and sufficiently well-sourced that they do not constitute original research, they are usually both unnecessary and potentially confusing. Similarly, dividing the list of battles into multiple blocks by inserting heading-like separations should be exceptional; if such a division is felt to be needed, a better solution may be to split the one campaignbox into two or more.

This infobox may be used to describe a particular planned or executed military operation or attack. For operations that resulted in combat, it can be used as an auxiliary template to the {{Infobox military conflict}}, if necessary; for other types of operations, including those that were planned but never executed, it may be used alone. In the case of conflicts that consisted of multiple independent operations, multiple copies of the box may be used on a single article.

{{{title}}}
Part of {{{conflict}}}
[[File:{{{image}}}|{{{image_size}}}|alt={{{alt}}}|upright={{{image_upright}}}|{{{alt}}}]] {{{caption}}}
Operational scope	{{{scope}}}
Location	{{{location}}}
Planned	{{{planned}}}
Planned by	{{{planned_by}}}
Commanded by	{{{commanded_by}}}
Target	{{{target}}}
Date	{{{executed}}} {{{time}}} {{{time-begin}}} – {{{time-end}}} ({{{timezone}}})
Executed by	{{{instigator}}}
Outcome	{{{outcome}}}
Casualties	{{{casualties}}}

{{Infobox operational plan
| name         = 
| partof       =
| image        = 
| caption      = 
| scope        =
| type         =
| location     =
| coordinates  = 
| map_type     = 
| map_size     = 
| map_caption  = 
| map_label    = 
| planned      = 
| planned_by   = 
| commanded_by = 
| objective    = 
| target       =
| date         = <!-- {{Start date|YYYY|MM|DD|df=y}} --> 
| time         =
| time-begin   =
| time-end     =
| timezone     =
| executed_by  = 
| outcome      = 
| casualties   = 
| fatalities   =
| injuries     =
}}

Example

Case Blue Fall Blau
Operational scope	Strategic offensive
Planned by	Wehrmacht
Objective	Capture the oil fields of the Caucasus
Date	Began June 28, 1942 (1942-06-28)
Executed by	Army Group South

{{Infobox operational plan
| name         = Case Blue<br />''Fall Blau''
| scope        = Strategic offensive
| planned      =
| planned_by   = Wehrmacht
| objective    = Capture the oil fields of the [[Caucasus]]
| executed     = Began {{Start date|1942|06|28}} 
| executed_by  = [[Army Group South]]
| outcome      =
| casualties   = 
}}

Parameters

Note: When using parameters, avoid the ambiguous abbreviation "N/A", and instead use "unknown" or "none". All subjective or qualitative judgements and numerical quantities or statistics must be cited to a reliable source (see WP:MILMOS#CITE).

• name – the name of the operational plan; names in multiple languages may be provided.
• partof – optional – the larger conflict containing the event described in the article.
• image – optional – an image. The image must be given in the form [[Image:Example.jpg|300px|alt=Example alt text]]; in particular, the thumb attribute must not be selected.
• caption – optional – the text to be placed below the image.
• location – optional – the location of the operation.
• coordinates – optional – the coordinates for the location above, given as {{coord}} with |display=inline,title.
• map_type – optional – the base map to be used for the location map, e.g. "Scotland"; see {{location map}} for more details.
• map_size – optional – width of the location map in pixels (px), e.g. "150"; defaults to: "220".
• map_caption – optional – caption displayed below the location map; defaults to "Location within {{{map_type}}}", e.g. "Location within Scotland".
• map_label – optional – the label placed next to the marker on the location map.
• scope – optional – the scope of the operation, such as "Strategic", "Operational", or "Tactical".
• type – optional – as an alternative to the scope field above, the type of operation, such as "Suicide attack" or "Ambush".
• planned – optional – the date(s) on which the plan was developed.
• planned_by – optional – the person or group responsible for developing the plan.
• commanded_by – optional – the person commanding the operation.
• objective – optional – the objective(s) of the operation.
• target – optional – as an alternative to the objective field above, the target(s) of the operation.
• date – optional – the date(s), if any, on which the operation was executed. use {{Start date}} (and {{End date}} if required)
• time – optional – the time, if any, at which the operation was executed.
• time-begin and time-end – optional – as an alternative to the time field above, the start and end times, respectively.
• timezone – optional – the timezone of the location of the operation; UTC+X, UTC-X, or UTC (i.e. offset from UTC) is preferred.
• executed_by – optional – the people, groups, units, or formations responsible for executing the operation.
• outcome – optional – the outcome of the operation from the perspective of the planners.
• casualties – optional – any casualties occurring during the execution of the operation.
• fatalities – optional – as an alternative to the casualties field above, the number of fatalities occurring during the execution of the operation.
• injuries – optional – as an alternative to the casualties field above, the number of injuries occurring during the execution of the operation.

Microformat

The HTML mark-up produced by this template includes an hCalendar microformat that makes event details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Classes used

The HTML classes this microformat uses include:

• attendee
• contact
• description
• dtend
• dtstart
• location
• organiser
• summary
• url
• vevent

Please do not rename or remove these classes
nor collapse nested elements which use them.

Tracking category

• Category:Pages using infobox military operation with unknown parameters (0)

See also

• {{Infobox military conflict}}

Microformat

The HTML markup produced by this template includes an hCalendar microformat, which makes the event details parsable by computers, either acting automatically to catalogue article across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to a calendar or diary application. Within the hCalendar is a Geo microformat, which additionally makes the coordinates (latitude & longitude) parsable, so that they can be, say, looked up on a map, or downloaded to a GPS unit. For more information about the use of microformats on Wikipedia, please see the microformat project.

Dates will only be included if you use {{Start date}} or {{End date}} (use the former for single dates, but do not use any of these if the date is before 1583 CE). {{End date}} requires that a time be specified, but display of this time may be suppressed by adding |nodate=yes to the end.

To include a URL, use {{URL}}.

hCalendar uses HTML classes including:

• attendee
• dtend
• dtstart
• location
• summary
• url
• vevent

Geo is produced by calling {{coord}}, and uses HTML classes:

• geo
• latitude
• longitude

Please do not rename or remove these classes nor collapse nested elements which use them.
Also, when giving coordinates, please don't be overly precise.

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools.

See the monthly error report for this template.

TemplateData for Infobox military conflict

Summarize information about a particular military conflict (a battle, campaign, war, or group of related wars).

Template parameters

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Conflict	conflict	The name of the conflict being described.	Line	required
Width	width	Width of the infobox. Default 315px	String	optional
Part of	partof	The larger conflict containing the event described in the article.	Page name	optional
Image	image	An image for the warbox given in the form Example.jpg.	String	optional
Image size	image_size	The size of the image	String	optional
Caption	caption	The text to be placed below the image.	String	optional
Date	date	The date of the conflict described. Convention is to give the actual date for battles and the years for wars, but this does not always apply.	String	optional
Place	place	The location of the conflict.	String	required
Coordinates	coordinates	The location of the structure, given as a coordinate pair by using {{coord}} with display=inline,title.	String	optional
Map Type	map_type	The base map to be used for the location map, e.g. "Scotland"; see {{location map}} for more details.	String	optional
Map Relief	map_relief	"yes" if the location map is a relief map.	String	optional
Latitude	latitude	Latitude for placing the marker on the location map.	Number	optional
Longitude	longitude	Longitude for placing the marker on the location map.	Number	optional
Map Size	map_size	Width of the location map in pixels (px). Default 220	Number	optional
Map Marker	map_mark	File to use as the location map marker. Default red_pog.svg	String	optional
Map Marker Size	map_marksize	Width of the location map marker in pixels (px). Default 8	Number	optional
Map Caption	map_caption	Caption displayed below the location map. Default Location within {{{map_type}}}	String	optional
Map Label	map_label	The label placed next to the marker on the location map.	Line	optional
Territory	territory	Any changes in territorial control as a result of the conflict; this should not be used for overly lengthy descriptions of the peace settlement.	String	optional
Result	result	this parameter may use one of several standard terms: "X victory", "Decisive X victory" or "Inconclusive". The choice of term should reflect what the sources say. In cases where the standard terms do not accurately describe the outcome, a link to the section of the article where the result is discussed in detail (such as "See the 'Aftermath' section") should be used instead of introducing non-standard terms like "marginal" or "tactical" or contradictory statements like "decisive tactical victory but strategic defeat". It is better to omit this parameter altogether than to engage in speculation about which side won or by how much.	Line	optional
Status	status	For ongoing conflicts, the current status of the conflict.	Line	optional
"Combatants" Header Text	combatants_header	Sets the header text for the combatants section. Default Belligerents	Line	optional
Combatant 1	combatant1	A party participating in the conflict.	String	optional
Combatant 2	combatant2	A party participating in the conflict.	String	optional
Combatant 3	combatant3	A party participating in the conflict. (only if the conflict has three distinct "sides")	String	optional
Combatant 1a	combatant1a	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 1 field.	String	optional
Combatant 2a	combatant2a	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 2 field.	String	optional
Combatant 3a	combatant3a	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 3 field.	String	optional
Combatant 1b	combatant1b	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 1 field.	String	optional
Combatant 2b	combatant2b	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 2 field.	String	optional
Combatant 3b	combatant3b	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 3 field.	String	optional
Combatant 1c	combatant1c	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 1 field.	String	optional
Combatant 2c	combatant2c	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 2 field.	String	optional
Combatant 3c	combatant3c	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 3 field.	String	optional
Combatant 1d	combatant1d	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 1 field.	String	optional
Combatant 2d	combatant2d	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 2 field.	String	optional
Combatant 3d	combatant3d	In cases where the parties significantly changed over the course of the conflict, this field may be used to provide additional rows for the Combatant 3 field.	String	optional
Commander of Combatant 1	commander1	The commanders of the military forces of Combatant (1) involved.	String	optional
Commander of Combatant 2	commander2	The commanders of the military forces of Combatant 2 involved.	String	optional
Commander of Combatant 3	commander3	The commanders of the military forces of Combatant 3 involved.	String	optional
Units of Combatant 1	units1	The units or formations of Combatant 1 involved. If a large number of distinct formations is present, it may be better to reference an order of battle in the body of the article than to include the entire list in this field.	String	optional
Units of Combatant 2	units2	The units or formations of Combatant 2 involved. If a large number of distinct formations is present, it may be better to reference an order of battle in the body of the article than to include the entire list in this field.	String	optional
Units of Combatant 3	units3	The units or formations of Combatant 3 involved. If a large number of distinct formations is present, it may be better to reference an order of battle in the body of the article than to include the entire list in this field.	String	optional
Strength of Combatant 1	strength1	The numerical strength of Combatant 1.	String	optional
Strength of Combatant 2	strength2	The numerical strength of Combatant 2.	String	optional
Strength of Combatant 3	strength3	If Combatant 3 is set, this field is for the numerical strength of Combatant 3. If Combatant 3 is not set, this is an alternate combined field for use where only the total participation in a conflict is known.	String	optional
Casualties of Combatant 1	casualties1	Casualties suffered by Combatant 1, including dead, wounded, missing, captured, and civilian deaths. Terms such as "dead" (or "killed"), "wounded", or "captured" should be used in place of abbreviations such as "KIA" or "POW".	String	optional
Casualties of Combatant 2	casualties2	Casualties suffered by Combatant 2, including dead, wounded, missing, captured, and civilian deaths. Terms such as "dead" (or "killed"), "wounded", or "captured" should be used in place of abbreviations such as "KIA" or "POW".	String	optional
Casualties of Combatant 3	casualties3	If Combatant 3 is set, this field is for the casualties suffered by Combatant 3, including dead, wounded, missing, captured, and civilian deaths. Terms such as "dead" (or "killed"), "wounded", or "captured" should be used in place of abbreviations such as "KIA" or "POW". If combatant3 is not set, this is an alternate combined field for use where only the total casualties of a conflict are known, or where civilian casualties cannot be directly attributed to either side.	String	optional
Notes	notes	Optional field for further notes; this should only be used in exceptional circumstances.	String	optional
Campaignbox	campaignbox	Optional field for appending a campaignbox template to the bottom of the infobox, which allows both boxes to float as a single element (useful if there are subsequent left floating images, which would otherwise not be able to float above the campaign box); the template must be specified in the format {{Campaignbox XYZ}}.	String	optional

See also

• {{Infobox military operation}}
• {{Infobox civil conflict}}
• {{Infobox civilian attack}}