Template:Multiple image

Template documentation[view] [edit] [history] [purge]

This template creates a box with two to ten images arranged vertically or horizontally with captions for the entire box and/or for each images.

Usage

• align defaults to "right"
• direction defaults to "horizontal"
• header_align defaults to "center"
• footer_align defaults to "left"
• image1 is name of first image. Similarly for image2, etc.
• width1 is width of first image. Similarly for width2, etc.
  • width overrides width1, width2, width3, etc. If you want the images to be different sizes, do not provide the width parameter.
• alt1 is alt text of first image (see WP:ALT). Similarly for alt2, etc.
• caption1 is caption of first image. Similarly for caption2, etc.
• link1 is where the first page links to. Similarly for link2, etc. If not specified, image links to the image description page as usual. If specified to the empty value, the image does not link anywhere; this should be used for purely decorative images as per WP:ALT.
  Important: If the image is under a free license like the GFDL or a CC license, you must not use this parameter as the terms of those licenses require the license, or a link to it, to be reproduced with the image. The image must, therefore, link to its image page. Public domain and (theoretically) fair use images are not subject to this restriction.
• background color defines the background color between the border of the box and the images.
• header, footer, background color and captions are optional.

{{multiple image
<!-- Essential parameters -->
| align     = <!-- left/right/center/none --> 
| direction = <!-- horizontal/vertical -->
| width     = <!-- Digits only; no "px" suffix, please -->

<!-- Image 1 -->
| image1    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width1    = 
| alt1      = 
| caption1  = 

<!-- Image 2 -->
| image2    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width2    = 
| alt2      = 
| caption2  = 

<!-- Image 3 -->
| image3    = <!-- Filename only; no "File:" or "Image:" prefix, please -->
| width3    = 
| alt3      = 
| caption3  =

<!-- up to |image10 is accepted -->

<!-- Extra parameters -->
| header            = 
| header_align      = <!-- left/right/center -->
| header_background = 
| footer            = 
| footer_align      = <!-- left/right/center -->
| footer_background = 
| background color  = 
}}

Examples

File:Yellow card.svg

File:Red card.svg

Players are cautioned with a yellow card and sent off with a red card.

{{multiple image
| footer    = Players are cautioned with a yellow card and sent off with a red card.
| width     = 60

| image1    = Yellow card.svg
| alt1      = Yellow cartouche
| caption1  = 

| image2    = Red card.svg
| alt2      = Red cartouche
| caption2  = 
}}

PNG transparency demonstration

File:PNG transparency demonstration 1.png

A PNG image with an 8-bit transparency layer...

File:PNG transparency demonstration 2.png

...here overlaid onto a checkered background.

{{multiple image
| align     = left
| direction = vertical
| header    = [[PNG]] transparency demonstration
| width     = 200

| 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 overlaid onto a checkered background.
}}

File:Ribbon numeral 2.png

File:Ribbon numeral 3.png

File:Ribbon numeral 4.png

When a user has many of one type of barnstar,

they can represent them with ribbons and these numerals to indicate the count.

{{multiple image
| footer   = When a user has many of one type of {{W|WP:BARN|barnstar}},
they can represent them with {{W|WP:RIBBON|ribbons}}
and these numerals to indicate the count.
| width    = 60

| image1   = Ribbon numeral 2.png
| alt1     = 2

| image2   = Ribbon numeral 3.png
| alt2     = 3

| image3   = Ribbon numeral 4.png
| alt3     = 4
}}

Example with background color

File:Adoxa moschatellina 210406.jpg

File:Adoxa moschatellina 210406a.jpg

File:Adoxa moschatellina blatt.jpeg

Adoxa (Adoxa moschatellina)

{{multiple image
| 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. They are in groups of three, each with three lobes.

| footer={{w|Adoxa}} (''Adoxa moschatellina'')
| footer_background=#BBDD99
| background color=#BBDD99
| footer_align=center
| width=160
}}

Example with links

File:Frecklesmule.jpg

A mule
骡子, luózi

File:Donkey 1 arp 750px.jpg

A donkey
驴子, lǘzi

File:Rainbow trout.png

A fish
鱼, yú

The mule links to Mule, the donkey does not link anywhere, and the trout links to its image description page as usual.

{{multiple image
| footer    = The mule links to ''{{W|Mule}}'', the donkey does not link anywhere, and the trout links to its image description page as usual.
| align     = left

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

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

| image3    = Rainbow_trout.png
| width3    = 91
| alt3      = A trout
| caption3  = <center>A fish<br />
{{lang|zh|2=鱼}}, ''yú''</center>
}}

Horizontal placement

Vertical direction places the images on one straight line (column) downwards from the first image, while horizontal direction places the images left to right on multiple lines (rows):

vertical

File:Ribbon numeral 2.png

File:Ribbon numeral 3.png

File:Ribbon numeral 4.png

horizontal

File:Ribbon numeral 2.png

File:Ribbon numeral 3.png

File:Ribbon numeral 4.png

However, this will not be apparent if only two images are used, as the template with "direction = horizontal" will place both images on different lines (rows), creating a blank space. Thus Template:Double image must be used. Similarly, if one wishes to display three images side-by-side on one line, Template:Triple image must be used.

Matching image heights

This trick is not required if all images have the same aspect ratio, where |width= suffices

• Decide on a common height for the images, say 100 pixels.
• Examine 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)"
• For non-square images, use these figures to construct an expression for the |widthn= parameters, of the form:
  • {{#expr: (dh * ow / oh) round 0}}
• where
  • dh is the desired height in pixels (100)
  • ow is the original width in pixels (750 or 300)
  • oh is the original height in pixels (536 or 300)
• For square images, simply set the appropriate |widthn= to be the desired height. If all are square, only |width= needs to be set.

File:Donkey 1 arp 750px.jpg

A donkey, not square and originally 536 pixels high

File:Rainbow trout.png

A fish, square and originally 300 pixels high

The two images are both rendered 100 pixels high

{{multiple image
| footer    = The two images are both rendered 100 pixels high
| align     = right

| image1    = Donkey 1 arp 750px.jpg
| width1    = {{#expr: (100 * 750 / 536) round 0}}
| alt1      = A donkey
| caption1  = A donkey, not square and originally 536 pixels high

| image2    = Rainbow_trout.png
| width2    = 100
| alt2      = A trout
| caption2  = A fish, square and originally 300 pixels high
}}

See also

• {{Auto images}} – automatically sizes a set of horizontal images
• {{Double image}}
• {{Triple image}}
• {{Gallery}}

The above documentation is transcluded from Template:Multiple image/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.

No description.

Template parameters

Parameter		Description	Type	Status
image1	image1	no description	Unknown	suggested
image2	image2	no description	Unknown	optional
image3	image3	no description	Unknown	optional
image4	image4	no description	Unknown	optional
image5	image5	no description	Unknown	optional
image6	image6	no description	Unknown	optional
image7	image7	no description	Unknown	optional
image8	image8	no description	Unknown	optional
image9	image9	no description	Unknown	optional
image10	image10	no description	Unknown	optional
align	align	no description	Unknown	suggested
direction	direction	no description	Unknown	suggested
width	width	no description	Unknown	suggested
width1	width1	no description	Unknown	optional
width2	width2	no description	Unknown	optional
width3	width3	no description	Unknown	optional
width4	width4	no description	Unknown	optional
width5	width5	no description	Unknown	optional
width6	width6	no description	Unknown	optional
width7	width7	no description	Unknown	optional
width8	width8	no description	Unknown	optional
width9	width9	no description	Unknown	optional
width10	width10	no description	Unknown	optional
background color	background color	no description	Unknown	optional
header	header	no description	Unknown	optional
header_align	header_align	no description	Unknown	optional
header_background	header_background	no description	Unknown	optional
link1	link1	no description	Unknown	suggested
alt1	alt1	no description	Unknown	suggested
caption1	caption1	no description	Unknown	suggested
link2	link2	no description	Unknown	optional
alt2	alt2	no description	Unknown	optional
caption2	caption2	no description	Unknown	optional
link3	link3	no description	Unknown	optional
alt3	alt3	no description	Unknown	optional
caption3	caption3	no description	Unknown	optional
link4	link4	no description	Unknown	optional
alt4	alt4	no description	Unknown	optional
caption4	caption4	no description	Unknown	optional
link5	link5	no description	Unknown	optional
alt5	alt5	no description	Unknown	optional
caption5	caption5	no description	Unknown	optional
link6	link6	no description	Unknown	optional
alt6	alt6	no description	Unknown	optional
caption6	caption6	no description	Unknown	optional
link7	link7	no description	Unknown	optional
alt7	alt7	no description	Unknown	optional
caption7	caption7	no description	Unknown	optional
link8	link8	no description	Unknown	optional
alt8	alt8	no description	Unknown	optional
caption8	caption8	no description	Unknown	optional
link9	link9	no description	Unknown	optional
alt9	alt9	no description	Unknown	optional
caption9	caption9	no description	Unknown	optional
link10	link10	no description	Unknown	optional
alt10	alt10	no description	Unknown	optional
caption10	caption10	no description	Unknown	optional
footer	footer	no description	Unknown	optional
footer_align	footer_align	no description	Unknown	optional
footer_background	footer_background	no description	Unknown	optional