Editing Template:Multiple image/doc (section)

==Examples==

{{multiple image
 | width = 60
 | image1 = Yellow card.svg
 | alt1 = Yellow cartouche
 | image2 = Red card.svg
 | alt2 = Red cartouche
 | footer = Players are cautioned with a yellow card and sent off with a red card.
}}
<pre>
{{multiple image
 | width = 60
 | image1 = Yellow card.svg
 | alt1 = Yellow cartouche
 | image2 = Red card.svg
 | alt2 = Red cartouche
 | footer = Players are cautioned with a yellow card and sent off with a red card.
}}
</pre>
{{clr}}
{{multiple image
 | align = left
 | direction = vertical
 | width = 200
 | header = [[wikipedia:Portable Network Graphics|PNG]] transparency demonstration
 | image1 = PNG transparency demonstration 1.png
 | alt1 = Colored dice with white background
 | caption1 = A PNG image with an 8-bit transparency layer...
 | image2 = PNG transparency demonstration 2.png
 | alt2 = Colored dice with checkered background
 | caption2 = ...here overlaying a checkered background.
}}
<pre>
{{multiple image
 | align = left
 | direction = vertical
 | width = 200
 | header = [[wikipedia:Portable Network Graphics|PNG]] transparency demonstration
 | image1 = PNG transparency demonstration 1.png
 | alt1 = Colored dice with white background
 | caption1 = A PNG image with an 8-bit transparency layer...
 | image2 = PNG transparency demonstration 2.png
 | alt2 = Colored dice with checkered background
 | caption2 = ...here overlaying a checkered background.
}}
</pre>
{{clear}}
{{multiple image
 | width = 60
 | image1=Ribbon numeral 2.png | alt1=2
 | image2=Ribbon numeral 3.png | alt2=3
 | image3=Ribbon numeral 4.png | alt3=4
 | footer = When a user has many of one type of barnstar, they can represent them with ribbons and these numerals to indicate the count.
}}
<pre>
{{multiple image
 | width = 60
 | image1=Ribbon numeral 2.png | alt1=2
 | image2=Ribbon numeral 3.png | alt2=3
 | image3=Ribbon numeral 4.png | alt3=4
 | footer = When a user has many of one type of barnstar, they can represent them with ribbons and these numerals to indicate the count.
}}
</pre>
{{clrr}}

===With ''background color''===
{{multiple image
 | align = left
 | background color = #BBDD99
 | width = 160
 | image1 = Adoxa_moschatellina_210406.jpg
 | alt1 = Green herb with a few tiny yellow-white flowers
 | image2 = Adoxa_moschatellina_210406a.jpg
 | alt2 = Three small white and yellow flowers before green-leaf background
 | image3 = adoxa_moschatellina_blatt.jpeg
 | alt3 = Leaves of a plant, in groups of three each with three lobes
 | footer_background = #BBDD99
 | footer_align = center
 | footer = [[wikipedia:Adoxa|Adoxa]] (''Adoxa moschatellina'')
}}
{{clear}}
<syntaxhighlight lang="moin" style="overflow:auto;">
{{multiple image
 | background color = #BBDD99
 | width = 160
 | image1 = Adoxa_moschatellina_210406.jpg
 | alt1 = Green herb with a few tiny yellow-white flowers
 | image2 = Adoxa_moschatellina_210406a.jpg
 | alt2 = Three small white and yellow flowers before green-leaf background
 | image3 = adoxa_moschatellina_blatt.jpeg
 | alt3 = Leaves of a plant, in groups of three each with three lobes
 | footer_background = #BBDD99
 | footer_align = center
 | footer = [[wikipedia:Adoxa|Adoxa]] (''Adoxa moschatellina'')
}}
</syntaxhighlight>
{{clear}}

===With links (''link[n]'')===
{{multiple image
 | align = left

 | image1 = Frecklesmule.jpg
 | width1 = 143
 | alt1 = A mule
 | link1 = Mule
 | caption1 = A mule<br />(骡子 ''luózi'')

 | image2 = Donkey 1 arp 750px.jpg
 | width2 = 150
 | alt2 = A donkey
 | link2 = 
 | caption2  = A donkey<br />(驴子 ''lǘzi'')

 | image3 = Rainbow_trout.png
 | width3 = 91
 | alt3 = A trout
 | caption3  = A fish<br />(鱼 ''yú'')

 | footer = The image of the mule links to [[wikipedia:Mule|Mule]]; the image of the donkey does not link anywhere; the image of the trout links to a standard image description page.
}}
{{clrl}}
<syntaxhighlight lang="moin" style="overflow:auto;">
{{multiple image
 | align = left

 | image1 = Frecklesmule.jpg
 | width1 = 143
 | alt1 = A mule
 | link1 = Mule
 | caption1 = A mule<br />(骡子 ''luózi'')

 | image2 = Donkey 1 arp 750px.jpg
 | width2 = 150
 | alt2 = A donkey
 | link2 = 
 | caption2  = A donkey<br />(驴子 ''lǘzi'')

 | image3 = Rainbow_trout.png
 | width3 = 91
 | alt3 = A trout
 | caption3  = A fish<br />(鱼 ''yú'')

 | footer = The image of the mule links to [[wikipedia:Mule|Mule]]; the image of the donkey does not link anywhere; the image of the trout links to a standard image description page.
}}
</syntaxhighlight>
{{clrr}}

===Using ''direction''===
By default, the images the template presents are displayed horizontally, as a row (see left; equivalent to setting <code>|direction=horizontal</code>). To display them vertically, i.e. as a column, set <code>direction=vertical</code> (see right).
{{multiple image
 |align=left |direction=horizontal |header=(horizontal) |width=60
 |image1=Ribbon numeral 2.png |image2=Ribbon numeral 3.png |image3=Ribbon numeral 4.png
}}
{{multiple image
 |align=right |direction=vertical |header=(vertical) |width=60
 |image1=Ribbon numeral 2.png |image2=Ribbon numeral 3.png |image3=Ribbon numeral 4.png
}}
{{clear}}
On mobile devices some images may always be displayed vertically if the total width is larger than around 320.

===To match image heights===
Note: The following is unnecessary if all the images presented by the template have the same [[wikipedia:Aspect ratio (image)|aspect ratio]]; if so, simply set <code>width</code> accordingly.
* Decide on a total width for all the images, say 320px
* Set the total width using <code>total_width</code>

{{multiple image
 | align = right
 | total_width = 320

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Rectangular image of a donkey, originally 536 pixels high.

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Square image of a trout, originally 300 pixels high.

 | footer = Both images have been rendered with the same height, and a total width of 320px
}}
<pre>
{{multiple image
 | align = right
 | total_width = 320

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Rectangular image of a donkey, originally 536 pixels high.

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Square image of a trout, originally 300 pixels high.

 | footer = Both images have been rendered with the same height, and a total width of 320px
}}
</pre>
{{clear}}
The aspect ratio of each image is automatically retrieved from the File metadata.  You can override the native width and height values by
* Examining the individual image pages to obtain the full resolution. For example:
** [[:File:Donkey 1 arp 750px.jpg]] shows "Donkey_1_arp_750px.jpg (750 × 536 pixels, file size: 125 KB, MIME type: image/jpeg)"
** [[:File:Rainbow trout.png]] shows "Rainbow_trout.png (300 × 300 pixels, file size: 158 KB, MIME type: image/png)"
* Specify the full width and height for each image, of the form:
** <code>width1</code> <code>height1</code> <code>width2</code> <code>height2</code>

=== Multiple rows ===
To create an array of images, with multiple rows, use <code>perrow</code>.  The value passed to <code>perrow</code> may be a single number, or a list of numbers delimited by <code>/</code>.  This feature may also be combined with <code>total_width</code> for multiple rows of images with the same total width.
{{multiple image|perrow = 2|total_width=300
| image1 = Kern_Theodolit_DKM2-A.jpg
| image2 = Total-Robotic-Station.jpg
| image3 = DumpyLevel.jpg
| image4 = GPS_Survey_Equipment_at_Weir_Dyke_Bridge_-_geograph.org.uk_-_336908.jpg
| footer = Surveying Equipment. Clockwise from upper left: Optical Theodolite, Robotic total station, Optical level, [[wikipedia:Real-time kinematic|RTK]] GPS Base station.
}}
<pre style="overflow:auto">
{{multiple image|perrow = 2|total_width=300
| image1 = Kern_Theodolit_DKM2-A.jpg
| image2 = Total-Robotic-Station.jpg
| image3 = DumpyLevel.jpg
| image4 = GPS_Survey_Equipment_at_Weir_Dyke_Bridge_-_geograph.org.uk_-_336908.jpg
| footer = Surveying Equipment. Clockwise from upper left: Optical Theodolite, Robotic total station, Optical level, [[wikipedia:Real-time kinematic|RTK]] GPS Base station.
}}
</pre>
{{clrr}}

=== Removing the image border ===
The border around the images can be removed using <code>image_style=border:none</code>.
{{multiple image
 | align = right
 | total_width = 320
 | image_style = border:none;

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Image of a donkey

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Image of a trout
}}
<pre style="overflow:auto">
{{multiple image
 | align = right
 | total_width = 320
 | image_style = border:none;

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Image of a donkey

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Image of a trout
}}</pre>
{{clrr}}

=== Increasing the gap between images ===
The gap between the images can be increased using <code>image_gap=N</code>, where N is the number of pixels (must be non-negative).
{{multiple image
 | align = right
 | total_width = 320
 | image_gap = 20

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Image of a donkey

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Image of a trout
}}
<pre style="overflow:auto">
{{multiple image
 | align = right
 | total_width = 320
 | image_gap = 20

 | image1 = Donkey 1 arp 750px.jpg
 | alt1 = A donkey
 | caption1 = Image of a donkey

 | image2 = Rainbow_trout.png
 | alt2 = A trout
 | caption2 = Image of a trout
}}</pre>