This template is a simplified version of {{Multiple image}}. It can be used to arrange two to six images in a horizontal row. They will automatically be scaled so that they are all of the same height and together have specified total width. Each image can have its own caption; the complete row can have a title.

Any number of horizontal rows of images can be placed underneath one another to form a combined set.

{{Auto images
| cont =         <!-- set to "true", "y", etc if template follows another {{Auto images}}, else omit -->
| boxclass =     <!-- default "wikitable" -->
| boxstyle = 
| title = 
| total_width =  <!-- of the image set; default "600" [pixels] -->
| align =        <!-- of the image set; alternatively, | float =  (see below) -->
| text_align =   <!-- applied to footer as well as captions -->
| image1 = 
| width1 = 
| height1 = 
| alt1 = 
| caption1 = 
| image2 = 
| width2 = 
| height2 = 
| alt2 = 
| caption2 = 
<!-- etc, to: -->
| image6 = 
| width6 = 
| height6 = 
| alt6 = 
| caption6 = 
| footer = 
}}

Parameters with numerical values, if unused, must be removed and not left blank; if left blank, they may cause undesirable side-effects. These include |widthN=, |heightN= and |total_width=. If |total_width= is omitted, the default value is 600.

Six parameters apply to the set of images as whole.

  • cont – any nonblank value (e.g. yes) is used to combine a row of images produced by this template with the one above (see below).
  • boxclass – use to replace/disable the default "wikitable" class used to style the box in which the images etc appear.
  • boxstyle – use to supplement the CSS styling applied to the box.
  • title – specifies an optional title placed at the top of the set of images.
  • total_width – optionally specifies the total width of the set of images. The default is 600 (pixels), which is good for a screen width of 800 and for printing.
  • align (or float) – specifies the alignment of the set of images:
    • left: aligns them to the left of the page, wrapping text to the right.
    • right: aligns them to the right of the page, wrapping text to the left.
    • center: aligns them to the centre of the page, with no text wrapping; this is the default.
    • left_nowrap (or none): aligns them to the left of the page, with no text wrapping to the right.
    • right_nowrap: aligns them to the right of the page, with no text wrapping to the left.
  • text_align – specifies the alignment of the caption text for each image as well as the overall footer. The default is left. It may be set to center or right.
  • footer – optionally specifies footer text which runs across the bottom of all of the images.

Each image is described by five parameters. "N" below takes the values 1, 2, ..., 6 for the maximum of six images:

  • widthN – this is the width in pixels of the full resolution version of the image in Commons or Wikipedia. Examine the individual image page to obtain the full resolution.
  • heightN – this is the height in pixels of the full resolution version of the image in Commons or Wikipedia.
  • imageN – the name of the image in Commons or Wikipedia (do not precede by "File:" or "Image:").
  • captionN – an optional caption for the image.
  • altN – alternative text. See WP:ALT.

The great advantage of this template over {{Multiple image}} is that if you decide to add or remove an image or change the total width of the row of images, you don't have to recalculate the widths. Thus:

{{Auto images
|total_width=300
|width1=1328 |height1= 990 |image1=Pereskia grandifolia areole.jpg |caption1=''Pereskia grandiflora''
|width2=4408 |height2=3229 |image2=Cut Cereus (brightened).jpg     |caption2=''Cereus'' cross-section showing the arrangement of areoles
|width3=2736 |height3=3648 |image3=Echinopsis candicans (3).jpg    |caption3=''Echinopsis candicans''
}}

produces:


Pereskia grandiflora

Cereus cross-section showing the arrangement of areoles

Echinopsis candicans
{{Auto images
| title = Cactus areoles
| align = right_nowrap
| total_width = 200
| text_align = center
|width1=2736 |height1=3648 |image1=Echinopsis candicans (3).jpg      |caption1=''Echinopsis candicans''
|width2= 528 |height2= 552 |image2=Astrophytum capricorne areole.jpg |caption2=''Astrophytum capricorne''
}}

produces:

Cactus areoles

Echinopsis candicans

Astrophytum capricorne
{{Auto images
| title = Cactus areoles
|width1=1328 |height1= 990 |image1=Pereskia grandifolia areole.jpg   |caption1=''Pereskia grandiflora'' |alt1=Shows leaves emerging from areoles
|width2=4408 |height2=3229 |image2=Cut Cereus (brightened).jpg       |caption2=''Cereus'' cross-section showing the arrangement of areoles
|width3=2736 |height3=3648 |image3=Echinopsis candicans (3).jpg      |caption3=''Echinopsis candicans''
|width4= 528 |height4= 552 |image4=Astrophytum capricorne areole.jpg |caption4=Close up of an areole of ''Astrophytum capricorne'' |alt4=Shows fine wool covering areoles
| footer = Areoles are characteristic of all cacti, whether or not they have leaves.
}}

produces:

Cactus areoles
Shows leaves emerging from areoles
Pereskia grandiflora

Cereus cross-section showing the arrangement of areoles

Echinopsis candicans
Shows fine wool covering areoles
Close up of an areole of Astrophytum capricorne
Areoles are characteristic of all cacti, whether or not they have leaves.

Combining rows of images

ಬದಲಾಯಿಸಿ

To produce multiple horizontal rows of images, the template can be repeated any number of times, using the same value of total_width each time. Specifying cont = yes (or any other nonblank value) on the second and subsequent uses ensures that there is only a single line between the two rows; without it there will be a double line.

{{Auto images
| title = Stages in the life of the [[American Robin]]
|width1= 500 |height1= 749 |image1=American Robin Nest.jpg
|width2=3888 |height2=2592 |image2=Robin's Nest - Charlotte NC.jpg
|width3=1024 |height3= 768 |image3=AmericanRobinChicksInNest 1.jpg
}}
{{Auto images |cont=yes
|width1= 600 |height1= 479 |image1=Robin chick 2 Galawebdesign.jpg
|width2=5184 |height2=3456 |image2=Turdus migratorius -Smithsonian National Zoological Park, Washington, USA -juvenile-8.jpg
|width3=1350 |height3=1024 |image3=Turdus-migratorius-002.jpg
}}

produces:

Stages in the life of the American Robin






Limitations, debugging

ಬದಲಾಯಿಸಿ
  • Only a maximum of six images are allowed in a row. Unless the total width is made large, which is undesirable for printing and for readers with smaller screens, more than this number of images means that they are likely to be rather small.
  • If the displayed images are not all of the same height, then the widthN and heightN parameters have been omitted or set incorrectly for one or more images. Recall that they should be the width and height of the highest resolution version of the image in Commons or Wikipedia.
  • A long title can force a row of images to be wider than the specified value of total_width.

Supporting templates

ಬದಲಾಯಿಸಿ