Template:Infobox weapon/doc

{{#ifeq:{{{noheader|}}}|yes||{{Documentation subpage}} {{high-use|4,000+}}

Usage
}}

Weapon infobox
A weapon infobox may be used to summarize information about a particular weapon or weapon system (such as a firearm, a sword, a grenade, an artillery piece, a torpedo, or a tank); cartridges and artillery shells should use infobox firearm cartridge instead. The infobox should be added using the infobox weapon template, as shown below:

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).

The infobox is intended as a quick reference. Don't add non-data items, like question marks, “none”, “see text” or links to article sections (the article's table of contents already does this). Only add “unknown” to assert that an information point is unknowable, not as a placeholder to show that it is missing from the article. Choose a representative model and indicate what it is with the  parameter, instead of listing multiple data items in one field.

The template can also be used for general categories of weapons, such as tank and Katyusha rocket launcher, by including only some general characteristics.

General parameters:
 * name – the formal name of the weapon.
 * image – optional – an image of the weapon. The image must be given in the form [[Image:Example.jpg|300px]] ; in particular, the thumb attribute must not be selected.
 * caption – optional – the text to be placed below the image.
 * origin – optional – the country or place where the weapon originated or was first manufactured. Flag icons should be avoided in this field, per WP:MOSFLAG and WP:MILMOS.
 * type – optional – the type of weapon (e.g. "service rifle", "dress sword", and so forth).

Type selection parameters (these parameters control whether—and how—particular specification fields will be displayed; multiple ones may be enabled where appropriate):
 * is_ranged – "yes" if the weapon is a ranged weapon, such as a firearm or bow; must be left blank otherwise.
 * is_bladed – "yes" if the weapon is a bladed, pointed, or blunt hand-held weapon, such as a sword, mace, or polearm; must be left blank otherwise.
 * is_explosive – "yes" if the weapon is an explosive device, such as a grenade or bomb; must be left blank otherwise.
 * is_artillery – "yes" if the weapon is a type of artillery, such as a cannon or mortar; must be left blank otherwise.
 * is_vehicle – "yes" if the weapon is a self-propelled vehicle, such as a tank; must be left blank otherwise.
 * is_missile – "yes" if the weapon is a self-propelled missile or torpedo; must be left blank otherwise.
 * is_UK – "yes" if the field labels should use British/Commonwealth English (calibre, armour); must be left blank otherwise.

Service history parameters:
 * service – optional – the period (usually given in years) when the weapon was in service.
 * used_by – optional – the countries, armed forces, or other groups using the weapon; this may be omitted for weapons employed only in their country of origin.
 * wars – optional – any wars during which the weapon saw service.

Production history parameters:
 * designer – optional – the person or group responsible for designing the weapon.
 * design_date – optional – the date (usually given as a year) when the weapon was designed.
 * manufacturer – optional – the manufacturer of the weapon.
 * unit_cost – optional – the unit cost of the weapon; this should only be indicated for weapons currently being produced.
 * production_date – optional – the period (usually given in years) when the weapon was produced.
 * number – optional – the number of weapons of this type that were manufactured.
 * variants – optional – any variant models of the weapon.

General specification parameters:
 * spec_label – optional – a label for the specifications, to be used when data for a particular variant is indicated; should be left blank otherwise.
 * weight – optional – the weight of the weapon. For firearms, separate loaded and unloaded weights may be indicated.
 * length – optional – the total length of the weapon.
 * part_length – optional – a secondary length measurement. For firearms, this should be the barrel length; for bladed weapons, the length of the blade or head.
 * width – optional – the total width of the weapon, where applicable; this is intended for use with larger weapons, such as artillery or vehicles.
 * height – optional – the total height of the weapon, where applicable; this is intended for use with larger weapons, such as artillery or vehicles.
 * diameter – optional – the diameter of the weapon, where applicable; this is intended for use with explosives and missiles.
 * crew – optional – for crewed weapons, the number of people required.
 * passengers – optional – for vehicles, the number of passengers carried.

Ranged weapon specification parameters (most only available if is_ranged is set to "yes"; some are also activated when is_explosive or is_artillery is set to "yes"):
 * cartridge – optional – for firearms or artillery, the type(s) of cartridge or shell used.
 * cartridge_weight – optional – for firearms or artillery, the weight of the cartridge or shell used.
 * caliber – optional – for non-cartridge firearms or artillery, the caliber or interior diameter of the barrel; for cartridge-loaded firearms, caliber is indicated by the cartridge.
 * barrels – optional – for firearms or artillery, the number of distinct barrels; this may be omitted if the weapon is single-barreled.
 * action – optional – for firearms, the type of action (e.g. "flintlock").
 * rate – optional – the rate of fire. For automatic firearms and auto-loading artillery, this is usually the cyclic rate.  For other ranged weapons, an effective rate can be indicated if reputable sources for one are available.
 * velocity – optional – for firearms or artillery, the muzzle velocity of the fired projectile.
 * range – optional – the effective range of the weapon.
 * max_range – optional – the maximum range of the weapon; for firearms this should be the maximum sight setting if used.
 * feed – optional – for firearms, the feed system or magazine used.
 * sights – optional – for firearms or artillery, the type of sights used.

Artillery specification parameters (only available if is_artillery is set to "yes"):
 * breech – optional – for artillery, the type of breech mechanism.
 * recoil – optional – for artillery, the recoil system used.
 * carriage – optional – for artillery, the type of carriage used.
 * elevation – optional – for artillery, the vertical range of possible firing angles.
 * traverse – optional – for artillery, the horizontal range of possible firing angles.

Bladed weapon specification parameters (only available if is_bladed is set to "yes"):
 * blade_type – optional – for bladed weapons (e.g. swords), a description of the blade.
 * hilt_type – optional – for bladed weapons (e.g. swords), a description of the hilt.
 * sheath_type – optional – for bladed weapons (e.g. swords), a description of the scabbard or sheath, if any.
 * head_type – optional – for blunt or striking weapons (e.g. axes, polearms, or maces), a description of the head.
 * haft_type – optional – for blunt or striking weapons (e.g. axes, polearms, or maces), a description of the haft.

Explosive weapon specification parameters (only available if is_explosive or is_missile is set to "yes"):
 * filling – optional – the explosive filling material or warhead.
 * filling_weight – optional – the weight of the explosive material or warhead.
 * detonation – optional – the detonation trigger type (e.g. "timer", "pressure", "motion sensor").
 * yield – optional – for larger explosives, the yield (in tons of TNT) of the device.

Vehicle/missile specification parameters (most only available if is_vehicle is set to "yes"; some are also activated if is_missile is set to "yes"): {{#ifeq:{{{noheader|}}}|yes||
 * armour – optional – the armour plating of the vehicle; different armour thickness at different points may be indicated if needed.
 * primary_weapon – optional – the primary armament mounted on the vehicle, if any.
 * secondary_weapon – optional – the secondary armament mounted on the vehicle, if any.
 * engine – optional – the type of engine used by the vehicle or missile.
 * engine_power – optional – the power output of the engine, usually in hp or kW.
 * pw_ratio – optional – the power-to-weight ratio, usually in hp/tonne.
 * transmission – optional – the type of transmission used by the vehicle.
 * payload_capacity – optional – the overall payload capacity weight of the vehicle.
 * propellant – optional – for missiles, the propellant used.
 * fuel_capacity – optional – the fuel capacity of the vehicle.
 * suspension – optional – the suspension of the vehicle.
 * clearance – optional – the ground clearance of the vehicle.
 * wingspan – optional – for missiles, the wingspan.
 * vehicle_range – optional – the operational range of the vehicle or missile.
 * ceiling – optional – for missiles, the flight ceiling.
 * altitude – optional – for missiles, the normal flight altitude.
 * depth – optional – for underwater weapons such as torpedoes, the maximum operating depth.
 * boost – optional – for missiles, the maximum boost time.
 * speed – optional – the maximum speed of the vehicle or missile; this is usually the road speed, but other values may be indicated if appropriate.
 * guidance – optional – the guidance system used by the missile (or the vehicle, if unmanned).
 * steering – optional – the steering system used by the missile or vehicle.
 * accuracy – optional – for missiles, the guidance accuracy.
 * launch_platform – optional – for missiles, the launch platform.
 * transport – optional – for missiles, the transportation vehicle or method, if different from the launch platform.

Microformat
}}