View source for Help:Convert/parameter options

{{hatnote|This page may be incomplete or not up to date. Core overviews are [[Help:Convert]] and [[:Template:Convert]] (documentation)}}
This page wants to give an elaborate overview of the {{tlx|convert}}} parameters and their options. It is a technical overview.
*[[Help:Convert units]] • Simplified list of some commonly used units.
*[[Help:Convert messages]] • Error and warning messages.

== Units ==
*[[Help:Convert units]] • Simplified list of some commonly used units
*[[Module:Convert/documentation/conversion data/doc]] • Full list of units

== Rounding ==
By default, the output value is rounded to adjust its precision to match that of the input. An input such as 1234 is interpreted as 1234&nbsp;±&nbsp;0.5, while 1200 is interpreted as 1200&nbsp;±&nbsp;50, and the output value is displayed accordingly, taking into account the scale factor used in the conversion.

If the default is not wanted, the precision of output values can be specified using:
* <code>|''N''</code> (where <code>''N''</code> is a number) to specify the number of digits to be displayed after the [[decimal mark]] (round output to ''N'' decimal places)
* <code>|''-N''</code> (where <code>''-N''</code> is a negative number) to specify the number of digits before the decimal mark that should be replaced with zero (round output to nearest 10<sup>''N''</sup>).
* <code>|sigfig=''N''</code> (where <code>''N''</code> is a positive number) to specify the number of [[significant digits]] (round output to ''N'' significant figures)
* <code>|round=5</code> to round the output to the nearest multiple of 5

Examples:
*<code><nowiki>{{convert|1234|ft|m}}</nowiki></code> → {{convert|1234|ft|m}}
*<code><nowiki>{{convert|1234|ft|m|2}}</nowiki></code> → {{convert|1234|ft|m|2}}
*<code><nowiki>{{convert|1234|ft|m|-1}}</nowiki></code> → {{convert|1234|ft|m|-1}}
*<code><nowiki>{{convert|1234|ft|m|round=5}}</nowiki></code> → {{convert|1234|ft|m|round=5}}
*<code><nowiki>{{convert|1234|ft|m|sigfig=2}}</nowiki></code> → {{convert|1234|ft|m|sigfig=2}}
*<code><nowiki>{{convert|1234|ft|m|sigfig=4}}</nowiki></code> → {{convert|1234|ft|m|sigfig=4}}
*<code><nowiki>{{convert|1230|ft|m}}</nowiki></code> → {{convert|1230|ft|m}}
*<code><nowiki>{{convert|1230|ft|m|0}}</nowiki></code> → {{convert|1230|ft|m|0}}
*<code><nowiki>{{convert|1230|ft|m|1}}</nowiki></code> → {{convert|1230|ft|m|1}}
*<code><nowiki>{{convert|5670|sqft}}</nowiki></code> → {{convert|5670|sqft}}
*<code><nowiki>{{convert|5670|sqft|-2}}</nowiki></code> → {{convert|5670|sqft|-2}}

== Spell ==
;Use US (en-US) spelling for unit names
Use {{para|sp|us}} to specify that unit names should be displayed with US spelling:
*<code><nowiki>{{convert|6|km}}</nowiki></code> → {{convert|6|km}}
*<code><nowiki>{{convert|6|km|sp=us}}</nowiki></code> → {{convert|6|km|sp=us}}

;Spell out numbers in words
Use {{para|spell|in}} to specify that the input value should be spelled in words, or {{para|spell|In}} (uppercase "<code>I</code>") to start with an uppercase letter:
*<code><nowiki>{{convert|5|mi|km|spell=in}}</nowiki></code> → {{convert|5|mi|km|spell=in}}
*<code><nowiki>{{convert|5|mi|km|spell=in|abbr=off|0}}</nowiki></code> → {{convert|5|mi|km|spell=in|abbr=off|0}}
*<code><nowiki>{{convert|5|mi|km|spell=In|0}}</nowiki></code> → {{convert|5|mi|km|spell=In|0}}
*<code><nowiki>{{convert|5|mi|km|spell=In|abbr=off|0}}</nowiki></code> → {{convert|5|mi|km|spell=In|abbr=off|0}}
*<code><nowiki>{{convert|2+1/4|mi|km|abbr=off|0|spell=In}}</nowiki></code> → {{convert|2+1/4|mi|km|abbr=off|0|spell=In}}
*<code><nowiki>{{convert|2+1/4|mi|km|abbr=off|0|spell=In|sp=us}}</nowiki></code> → {{convert|2+1/4|mi|km|abbr=off|0|spell=In|sp=us}}

The input and output can be "flipped", as shown in these examples. Logically, the resulting first number is spelled:
*<code><nowiki>{{convert|5|mi||0|order=flip|spell=in}}</nowiki></code> → {{convert|5|mi||0|order=flip|spell=in}}
*<code><nowiki>{{convert|5|mi||0|order=flip|spell=In|abbr=off}}</nowiki></code> → {{convert|5|mi||0|order=flip|spell=In|abbr=off}}
The "<code>||</code>" provides an empty output unit to mean "use the default".

Both input and output values can be spelled:
*<code><nowiki>{{convert|5|mi|m|-2|spell=on|sp=us|abbr=off}}</nowiki></code> → {{convert|5|mi|m|-2|spell=on|sp=us|abbr=off}}
*<code><nowiki>{{convert|5|mi|m|-2|spell=On|sp=us|abbr=off}}</nowiki></code> → {{convert|5|mi|m|-2|spell=On|sp=us|abbr=off}}

== Fractions ==
An input value can be specified as a fraction.
*<code><nowiki>{{convert|1/2|in|mm|1}}</nowiki></code> → {{convert|1/2|in|mm|1}}
*<code><nowiki>{{convert|1/2|in|mm|1|adj=on}}</nowiki></code> → {{convert|1/2|in|mm|1|adj=on}}
*<code><nowiki>{{convert|2+1/2|in|mm|1}}</nowiki></code> → {{convert|2+1/2|in|mm|1}}
*<code><nowiki>{{convert|-2-1/4|in|mm|1}}</nowiki></code> → {{convert|-2-1/4|in|mm|1}}
*<code><nowiki>{{convert|1/2|in|mm|1|spell=in}}</nowiki></code> → {{convert|1/2|in|mm|1|spell=in}}

If two slashes are used, a horizontal fraction bar is used.
*<code><nowiki>{{convert|1//2|in|mm|1}}</nowiki></code> → {{convert|1//2|in|mm|1}}
*<code><nowiki>{{convert|2+1//2|in|mm|1}}</nowiki></code> → {{convert|2+1//2|in|mm|1}}

An output can be expressed with a fraction using <code>|frac=''N''</code> where ''N'' is the denominator. For example, <code>|frac=8</code> rounds the output to the nearest eighth.
*<code><nowiki>{{convert|219|mm|in|abbr=on}}</nowiki></code> → {{convert|219|mm|in|abbr=on}}
*<code><nowiki>{{convert|219|mm|in|abbr=on|frac=2}}</nowiki></code> → {{convert|219|mm|in|abbr=on|frac=2}}
*<code><nowiki>{{convert|219|mm|in|abbr=on|frac=4}}</nowiki></code> → {{convert|219|mm|in|abbr=on|frac=4}}
*<code><nowiki>{{convert|219|mm|in|abbr=on|frac=8}}</nowiki></code> → {{convert|219|mm|in|abbr=on|frac=8}}
*<code><nowiki>{{convert|222|mm|in|abbr=on|frac=8}}</nowiki></code> → {{convert|222|mm|in|abbr=on|frac=8}}

A fraction is applied to the output unit (if there is only one), or to non-SI units (if using a combination), except that if a precision is also specified, the fraction only applies to the [[Hand (unit)|hand]] unit.
*<code><nowiki>{{convert|18.45|in|m|frac=2}}</nowiki></code> → {{convert|18.45|in|m|frac=2}}
*<code><nowiki>{{convert|18.45|in|ft in hand cm|frac=2}}</nowiki></code> → {{convert|18.45|in|ft in hand cm|frac=2}}
*<code><nowiki>{{convert|18.45|in|ft in hand cm|frac=2|1}}</nowiki></code> → {{convert|18.45|in|ft in hand cm|frac=2|1}}

== Joins ==
The {{para|disp}} ("display") option may be used to "join" the input and output, as shown in the following examples.

{| class="wikitable"
! Convert !! Output !! Description
|-
| <code><nowiki>{{convert|2.4|m|ft}}</nowiki></code> || {{convert|2.4|m|ft}} || default
|-
| <code><nowiki>{{convert|2.4|m|ft|disp=b}}</nowiki></code> || {{convert|2.4|m|ft|disp=b}} || brackets (same as default)
|-
| <code><nowiki>{{convert|2.4|m|ft|disp=sqbr}}</nowiki></code> || {{convert|2.4|m|ft|disp=sqbr}} || square brackets
|-
| <code><nowiki>{{convert|2.4|m|ft|disp=or}}</nowiki></code> || {{convert|2.4|m|ft|disp=or}} || or
|-
| <code><nowiki>{{convert|2.4|m|ft|disp=comma}}</nowiki></code> || {{convert|2.4|m|ft|disp=comma}} || comma
|-
| <code><nowiki>{{convert|2.4|m|ft|disp=br}}</nowiki></code> || {{convert|2.4|m|ft|disp=br}} || "&lt;br&nbsp;/>", line break
|}

== Ranges ==
{{Convert/doc/range separator list}}

The following ranges provide different output when units are abbreviated.
{| class="wikitable"
! Convert !! Output
|-
| <code><nowiki>{{convert|3|and(-)|6|ft|abbr=on}}</nowiki></code> || {{convert|3|and(-)|6|ft|abbr=on}}
|-
| <code><nowiki>{{convert|3|to(-)|6|ft|abbr=on}}</nowiki></code> || {{convert|3|to(-)|6|ft|abbr=on}}
|-
| <code><nowiki>{{convert|3|x|6|ft|abbr=on}}</nowiki></code> || {{convert|3|x|6|ft|abbr=on}}
|}

Ranges can use more than two values.

{| class="wikitable"
! Convert !! Output
|-
| <code><nowiki>{{convert|3|x|4|x|24|in}}</nowiki></code> || {{convert|3|x|4|x|24|in}}
|-
| <code><nowiki>{{convert|3|x|4|to|6+1/2|x|8+3/4|in}}</nowiki></code> || {{convert|3|x|4|to|6+1/2|x|8+3/4|in}}
|}

Ranges can be specified in the first parameter.

{| class="wikitable"
! Convert !! Output
|-
| <code><nowiki>{{convert|3.2-7.5|ha}}</nowiki></code> || {{convert|3.2-7.5|ha}}
|-
| <code><nowiki>{{convert|3x4x24|in}}</nowiki></code> || {{convert|3x4x24|in}}
|}

== Extra words ==
Some options provide text that is included in the output, as shown in the following examples.

{| class="wikitable"
! Convert !! Output !! Description
|-
| <code><nowiki>{{convert|4|ft||adj=mid|-long}}</nowiki></code> || {{convert|4|ft||adj=mid|-long}} || adjectival with mid-text between input and output
|-
| <code><nowiki>{{convert|40|acre||adj=pre|planted}}</nowiki></code> || {{convert|40|acre||adj=pre|planted}} || text before the input unit
|-
| <code><nowiki>{{convert|4|m||disp=preunit|+ }}</nowiki></code> || {{convert|4|m||disp=preunit|+ }} || same text before the input and output units
|-
| <code><nowiki>{{convert|4|m||disp=preunit|+ |or more }}</nowiki></code> || {{convert|4|m||disp=preunit|+ |or more }} || different text before the input and output units
|-
| <code><nowiki>{{convert|20|impfloz||disp=x|, approximately }}</nowiki></code> || {{convert|20|impfloz||disp=x|, approximately }} || text before the output (replaces the join)
|-
| <code><nowiki>{{convert|100|m||disp=x|/day (|/day)}}</nowiki></code> || {{convert|100|m||disp=x|/day (|/day)}} || text before and after the output (replaces the join)
|}

In each of the above examples, "<code>||</code>" provides an empty output unit which causes the default output to be used. An output unit, possibly empty, must be specified to avoid the template interpreting the extra text as the output unit. For example, using <code><nowiki>{{convert|4|ft|adj=mid|-long}}</nowiki></code> has the same effect as using <code><nowiki>{{convert|4|ft|-long|adj=mid}}</nowiki></code>, namely that an error would occur because "<code>-long</code>" would be used as the output unit. The following illustrates the error (hover the mouse over the error text to see that the problem is due to "<code>-long</code>" ) and how it may be avoided.
*<code><nowiki>{{convert|4|ft|adj=mid|-long}}</nowiki></code> → {{convert|4|ft|adj=mid|-long}}
*<code><nowiki>{{convert|4|ft||adj=mid|-long}}</nowiki></code> → {{convert|4|ft||adj=mid|-long}}
*<code><nowiki>{{convert|4|ft| |adj=mid|-long}}</nowiki></code> → {{convert|4|ft| |adj=mid|-long}}
*<code><nowiki>{{convert|4|ft|m|adj=mid|-long}}</nowiki></code> → {{convert|4|ft|m|adj=mid|-long}}

== Displaying parts of a convert ==
The following examples show how to display only some part of the output result.

{| class="wikitable"
! Convert !! Output !! Description
|-
| <code><nowiki>{{convert|2|cuyd|m3}}</nowiki></code> || {{convert|2|cuyd|m3}} || normal convert
|-
| <code><nowiki>{{convert|2|cuyd|m3|abbr=values}}</nowiki></code> || {{convert|2|cuyd|m3|abbr=values}} || input and output values
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=unit}}</nowiki></code> || {{convert|2|cuyd|m3|disp=unit}} || input unit
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=unit|adj=on}}</nowiki></code> || {{convert|2|cuyd|m3|disp=unit|adj=on}} || input unit, adjectival (hyphenated)
|-
| <code><nowiki>{{convert|2|cuyd|cuyd|0|disp=out|abbr=off}}</nowiki></code> || {{convert|2|cuyd|cuyd|0|disp=out|abbr=off}} || input (workaround)
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=unit2}}</nowiki></code> || {{convert|2|cuyd|m3|disp=unit2}} || output unit (symbol)
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=unit2|abbr=off}}</nowiki></code> || {{convert|2|cuyd|m3|disp=unit2|abbr=off}} || output unit (name)
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=number}}</nowiki></code> || {{convert|2|cuyd|m3|disp=number}} || output value
|-
| <code><nowiki>{{convert|2|cuyd|m3|disp=out}}</nowiki></code> || {{convert|2|cuyd|m3|disp=out}} || output value and unit
|-
| <code><nowiki>{{convert|2|cuyd|m3|abbr=off|disp=out}}</nowiki></code> || {{convert|2|cuyd|m3|abbr=off|disp=out}} || output value and unit
|}

==Wrapping and line breaking==
Convert uses the regular '''space''' ("&nbsp;") and '''non-breaking space''' (<code>&amp;nbsp;</code> which shows: "&nbsp;") to control line-breaking (also called wrapping/nowrapping).

Wrapping is possible where a space ("&nbsp;") is used. Prevent wrapping is enforced by using the ''non-breaking space'', that ties and keeps text elements together.
::<code>3&nbsp;feet</code> ''may'' break after "3"
::<code>3&amp;nbsp;ft</code>, or {{replace|3&nbsp;ft|&nbsp;|{{red|_}}}}, ''will not'' break after "3"
In the examples below, an <code>&amp;nbsp;</code> is shown as "{{red|_}}" (red underscore): "<code>3{{red|_}}ft</code>".

A line break ({{purple|&lt;br/&gt;}}) ''forces'' a newline (line break), and so overrules any nowrap setting at that point.

;Within a measurement (value+unit)
The separator between the value and the unit can be a space or a nonbreaking space (<code>&amp;nbsp;</code>):
*When a unit is abbreviated (symbol is shown), the separator is <code>&amp;nbsp;</code>.
::<code><nowiki>{{convert|12|m|ft|abbr=on}}</nowiki></code> → {{replace|{{convert|12|m|ft|abbr=on}}|&nbsp;|{{red|_}}}}

*When a unit is not abbreviated (name is shown), the separator is a space.
::<code><nowiki>{{convert|12|m|ft}}</nowiki></code> → {{replace|{{convert|12|m|ft}}|&nbsp;|{{red|_}}}}
::This can be set (overruled) to be <code>&amp;nbsp;</code> by {{para|adj|j}} (for 'join').
::<code><nowiki>{{convert|12|m|ft|adj=j}}</nowiki></code> → {{replace|{{convert|12|m|ft|adj=j}}|&nbsp;|{{red|_}}}}

*Some units do not have a symbol and always use a space ([[Module:Convert/documentation/conversion data/doc#Use name|such as acre]]).
::<code><nowiki>{{convert|3|acre|m2|abbr=on}}</nowiki></code> → {{replace|{{convert|3|acre|m2|abbr=on}}|&nbsp;|{{red|_}}}}

*Except, option <code>|adj=j</code> ("join") forces the separator to be <code>&amp;nbsp;</code>.
::<code><nowiki>{{convert|3|acre|m2|adj=j}}</nowiki></code> → {{replace|{{convert|3|acre|m2|adj=j}}|&nbsp;|{{red|_}}}}

*Except, <code>&amp;nbsp;</code> is always used when a measurement is in multiple units.
::<code><nowiki>{{convert|1|ft|6|in|cm}}</nowiki></code> → {{replace|{{convert|1|ft|6|in|cm}}|&nbsp;|{{red|_}}}}
::<code><nowiki>{{convert|2|m|ftin}}</nowiki></code> → {{replace|{{convert|2|m|ftin}}|&nbsp;|{{red|_}}}}

*Except, if option <code>|adj=on</code> is used and the unit is not abbreviated, the separator is a hyphen ("-").
::<code><nowiki>{{convert|2|m|ftin|adj=on}}</nowiki></code> → {{replace|{{convert|2|m|ftin|adj=on}}|&nbsp;|{{red|_}}}}

* When the name of a number is used, <code>&amp;nbsp;</code> is used as the separator between the value and the name. For example, a measurement spelled as "12&nbsp;million metres" has <code>&amp;nbsp;</code> before "million" and a space afterwards.
::<code><nowiki>{{convert|12|e6m}}</nowiki></code> → {{replace|{{convert|12|e6m}}|&nbsp;|{{red|_}}}}

;Between measurements
* A space is used as the separator in a join between the first and second measurement.
::<code><nowiki>{{convert|3|ft|m}}</nowiki></code> → {{replace|{{convert|3|ft|m}}|&nbsp;|{{red|_}}}}

* Except for the special case ''before "["''&thinsp;:
::<code><nowiki>{{convert|12|in|cm|disp=sqbr|abbr=on}}</nowiki></code> → {{replace|{{convert|12|in|cm|disp=sqbr|abbr=on}}|&nbsp;|{{red|_}}}} (<code>&amp;nbsp;</code> before "[")

* Multiple output measurements (by listing units) always use a space between measurements (";&nbsp;" has a space after ";").
::<code><nowiki>{{convert|2|acre|m2 sqft ha}}</nowiki></code> → {{replace|{{convert|2|acre|m2 sqft ha}}|&nbsp;|{{red|_}}}}

;Between components of a measurement (e.g., in a range; between foot–inch)
* A measurement in multiple units always uses a space between components ("1&nbsp;foot 6&nbsp;inches" has <code>&amp;nbsp;</code> before the unit names, but a space after "foot").
::<code><nowiki>{{convert|1|ft|6|in|cm}}</nowiki></code> → {{replace|{{convert|1|ft|6|in|cm}}|&nbsp;|{{red|_}}}}

* In a range, spaces are generally used to separate items. For example, "to" and "or" have a space before and after in the following.
::<code><nowiki>{{convert|12|to|20|in|cm}}</nowiki></code> → {{replace|{{convert|12|to|20|in|cm}}|&nbsp;|{{red|_}}}}
::<code><nowiki>{{convert|12|or|20|in|cm}}</nowiki></code> → {{replace|{{convert|12|or|20|in|cm}}|&nbsp;|{{red|_}}}}

* The ranges <code>+/-</code> and <code>,</code> always use <code>&amp;nbsp;</code>:
::<code><nowiki>{{convert|12|+/-|2|in|cm}}</nowiki></code> → {{replace|{{convert|12|+/-|2|in|cm}}|&nbsp;|{{red|_}}}}
::<code><nowiki>{{convert|12|,|20|in|cm}}</nowiki></code> → {{replace|{{convert|12|,|20|in|cm}}|&nbsp;|{{red|_}}}}
* The "to(-)" range is an exception. When a unit is not abbreviated, "to" has <code>&amp;nbsp;</code> before and a space after.
::<code><nowiki>{{convert|12|to(-)|20|in|cm}}</nowiki></code> → {{replace|{{convert|12|to(-)|20|in|cm}}|&nbsp;|{{red|_}}}}

* The "x" range is an exception. When a unit is abbreviated, "×" has a space before and <code>&amp;nbsp;</code> after.
::<code><nowiki>{{convert|12|x|20|in|cm}}</nowiki></code> → {{replace|{{convert|12|x|20|in|cm}}|&nbsp;|{{red|_}}}}

;Overrule by setting a line break
* Parameter {{para|disp|br}} adds a forced line break (<code>&lt;br/&gt;</code>) between measurements; brackets are omitted.
::<code><nowiki>{{convert|12|m|ft|disp=br}}</nowiki></code> → {{replace|{{replace|{{convert|12|m|ft|disp=br}}|&nbsp;|{{red|_}}}} |<br/>|{{purple|'''&lt;br/&gt;'''}}<br/>}}

;Preview wikicode
To see the wikicode result of the convert template: put your <code><nowiki>{{convert|...}}</nowiki></code> code into [[Special:ExpandTemplates]] and then preview by clicking {{keypress|OK}}.

==Tables==
The following parameters are intended for use in [[Help:Tables|tables]].
{| class="wikitable"
! Parameter !! Description
|-
| <code>&#124;disp=table</code> || for a table cell with <code>align="right"</code>
|-
| <code>&#124;disp=tablecen</code> || for a table cell with <code>align="center"</code>
|-
| <code>&#124;sortable=on</code> || output a numeric hidden sort field for a sortable table
|}

The following shows the wikitext output by some example converts.
{| class="wikitable"
! Convert !! Resulting wikitext
|-
| <code><nowiki>{{convert|47.5|kg|lb}}</nowiki></code> || 47.5 kilograms (105&nbsp;lb)
|-
| <code><nowiki>{{convert|47.5|kg|lb|disp=table}}</nowiki></code> || align="right"&#124;47.5<br />&#124;align="right"&#124;105
|-
| <code><nowiki>{{convert|47.5|kg|lb|disp=tablecen}}</nowiki></code> || align="center"&#124;47.5<br />&#124;align="center"&#124;105
|-
| <code><nowiki>{{convert|47.5|kg|lb|sortable=on}}</nowiki></code> || &lt;span style="display:none">7001475000000000000&lt;/span>47.5 kilograms (105&nbsp;lb)
|}

===Fixed table===
This wikitext:
<syntaxhighlight lang="wikitext">
{|class="wikitable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table}}
| {{convert|47.5|kg|lb|disp=table}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table}}
| {{convert|74.1|kg|lb|disp=table}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table}}
| {{convert|31.5|kg|lb|disp=table}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table}}
| {{convert|52.7|kg|lb|disp=table}}
|}
</syntaxhighlight>

produces this table:
{|class="wikitable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table}}
| {{convert|47.5|kg|lb|disp=table}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table}}
| {{convert|74.1|kg|lb|disp=table}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table}}
| {{convert|31.5|kg|lb|disp=table}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table}}
| {{convert|52.7|kg|lb|disp=table}}
|}

===Sortable table===
This wikitext:
<syntaxhighlight lang="wikitext">
{|class="wikitable sortable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table|sortable=on}}
| {{convert|47.5|kg|lb|disp=table|sortable=on}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table|sortable=on}}
| {{convert|74.1|kg|lb|disp=table|sortable=on}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table|sortable=on}}
| {{convert|31.5|kg|lb|disp=table|sortable=on}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table|sortable=on}}
| {{convert|52.7|kg|lb|disp=table|sortable=on}}
|}
</syntaxhighlight>

produces this table:
{|class="wikitable sortable"
! align=right, rowspan="2" |
!colspan="2"| Length
!colspan="2"| Weight
|- style="vertical-align:bottom;"
!metres !!ft in !!kg !!lb
|-
! Lorem ipsum
| {{convert|28.1|m|ftin|disp=table|sortable=on}}
| {{convert|47.5|kg|lb|disp=table|sortable=on}}
|-
! Dolor sit amet
| {{convert|9.9|m|ftin|disp=table|sortable=on}}
| {{convert|74.1|kg|lb|disp=table|sortable=on}}
|-
! Consectetur
| {{convert|38.2|m|ftin|disp=table|sortable=on}}
| {{convert|31.5|kg|lb|disp=table|sortable=on}}
|-
! Adipisicing elit
| {{convert|18.7|m|ftin|disp=table|sortable=on}}
| {{convert|52.7|kg|lb|disp=table|sortable=on}}
|}

== Parameter list ==
{{Convert/doc/parameter list}}

Examples of number grouping:
*<code><nowiki>{{convert|1234|m|ft}}</nowiki></code> → {{convert|1234|m|ft}}
*<code><nowiki>{{convert|1234|m|ft|comma=5}}</nowiki></code> → {{convert|1234|m|ft|comma=5}}
*<code><nowiki>{{convert|12345|m|ft|comma=5}}</nowiki></code> → {{convert|12345|m|ft|comma=5}}
*<code><nowiki>{{convert|1234|m|ft|comma=gaps}}</nowiki></code> → {{convert|1234|m|ft|comma=gaps}}
*<code><nowiki>{{convert|1234|m|ft|comma=gaps5}}</nowiki></code> → {{convert|1234|m|ft|comma=gaps5}}
*<code><nowiki>{{convert|1,234,567|m|ft|comma=gaps5}}</nowiki></code> → {{convert|1,234,567|m|ft|comma=gaps5}}
*<code><nowiki>{{convert|1,234,567|m|ft|comma=off}}</nowiki></code> → {{convert|1,234,567|m|ft|comma=off}}

Examples of spelling input values:
*<code><nowiki>{{convert|10|mi|km|spell=in}}</nowiki></code> → {{convert|10|mi|km|spell=in}}
*<code><nowiki>{{convert|10|mi|km|spell=In}}</nowiki></code> → {{convert|10|mi|km|spell=In}}
*<code><nowiki>{{convert|1/3|mi|km|adj=on|spell=in}}</nowiki></code> → {{convert|1/3|mi|km|adj=on|spell=in}}

== Differences from templates previously used ==
Before December 2013, {{tl|convert}} was implemented by a series of templates, not a module. Following are some differences between the new and old convert implementations.
*Using <code><nowiki>{{subst:convert|...}}</nowiki></code> works with the module.
*The module checks unit types and displays an error message if a mismatch occurs.
*Ranges and all options, including <code>order=flip</code>, should work with all units.
*Scaled units like <code>e6USgal</code> are not predefined. With [[Module:Convert/documentation/conversion data introduction/doc#Engineering notation|some exceptions]], all units accept prefixes e3, e6, e9, e12, e15.
*The module uses an empty unit code rather than <code>0</code> to mean "use the default unit", as in <code><nowiki>{{convert|4|ft||adj=mid|-long}}</nowiki></code> (it is also possible to use <code><nowiki>{{convert|4|ft|0|adj=mid|-long}}</nowiki></code>, but that sets the output precision to zero).
*The functionality of <code><nowiki>{{convert/3}}</nowiki></code> and <code><nowiki>{{convert/4}}</nowiki></code> is handled by the module, except that the module does not support arbitrary text to separate items in a range. Furthermore, the predefined separator words such as "by" and "to" behave in exactly the same manner as they do for standard converts, so a conversion like <code><nowiki>{{convert/3|2|x|4|x|6|m|ft}}</nowiki></code> would need to use the new <code>*</code> separator rather than <code>x</code> to produce exactly the same output with the module.
*The module does not have a problem with template loops, and will allow pointless conversions like <code><nowiki>{{convert|123|m|m}}</nowiki></code>.

== Limitations ==
This is a list of features that the module may be expected to support, but which will not work.

Composite units cannot be used in a range:
*<code><nowiki>{{convert|2|ft|6|in|to|3|ft|9|in}}</nowiki></code> → {{convert|2|ft|6|in|to|3|ft|9|in}}

If an expression is wanted, it has to use <code><nowiki>{{#expr:...}}</nowiki></code>:
*<code><nowiki>{{convert|3*12|ft|mm}}</nowiki></code> → {{convert|3*12|ft|mm}}
*<code><nowiki>{{convert|{{#expr:3*12}}|ft|mm}}</nowiki></code> → {{convert|{{#expr:3*12}}|ft|mm}}