Editing Template:Convert/doc (section)

===Sorting===
Use {{para|sortable|on}} to include a ''hidden numerical sortkey'' in the output, suitable for use in a [[Help:Sorting|table with sortable columns]]. Technically, this places a hidden string before the actual displayed values:
:<code><nowiki>{{convert|10|m|ft|sortable=on}}</nowiki></code> {{nowrap|1=→ <code>&lt;span data-sort-value="7001100000000000000♠">&lt;/span>10 metres (33&nbsp;ft)</code>}}
:showing: {{convert|10|m|ft|sortable=on}}.

Use both {{para|disp|table}} and {{para|sortable|on}} together to produce table columns (pipe symbols) for each value in sortable columns:

:{| class="wikitable sortable"
!
! m
! m
! ft
|-
| A
| {{val|15.75|u=m}}
| {{convert|15+3/4|m|ft|disp=table|sortable=on}}
|-
| B
| {{val|15.5|u=m}}
| {{convert|15.5|m|ft|disp=table|sortable=on}}
|-
| C
| {{val|16|u=m}}
| {{convert|16.0|m|ft|disp=table|sortable=on}}
|-
| D
| {{val|16|u=m}}
| {{convert|16|m|ft|disp=table|sortable=on}}
|}

The generated sortkey is calculated in a consistent way based on both the value and its unit as passed to the convert template. In most cases convert uses the passed value converted to SI base units. It is therefore not necessarily the displayed value or other alternate units and is calculated regardless of output format options. Using different units or different order of units in individual rows should therefore not lead to incorrect sorting, although variations in rounding can give surprising results, since an unrounded number is used for the sortkey.