Template:Random slideshow/doc

This template creates a slideshow gallery with a randomised order – i.e. it changes when the page is purged. It is intended for use in portals and will not display in article space.

Usage

As many images and captions as desired may be specified, in the following format:

{{Random slideshow 
| First image  | first caption
| second image | second caption
| third image  | third caption
}}

Credits (e.g. "Photograph: Example") may be specified, using the following format

{{Random slideshow 
| First image  | first caption | credit1=
| second image | second caption | credit2=
| third image  | third caption | credit3=
}}

Parameters

|1=, |3=, |5=, ... (or equivalent positional parameters)

File name. The "File:" prefix is optional.

|2=, |4=, |6=, ... (or equivalent positional parameters)

Caption for the file.

|credit1=, |credit2=, |credit3=, ...

Credits for the file. Optional.

|width=

Maximum width for all images; default is 100% (intended for use inside portal components)

Can be specified as a % (e.g. 75%), or in ems (e.g. 30em), or in px (e.g. 200px)

If a unit is not specified, px is assumed (i.e. 350 is equivalent to 350px)

|random=

Set to no or false to turn off the randomisation.

Examples

to see these galleries in a different order

Cats

{{Box-header|title=Selected pictures}}
{{Random slideshow 
| File:Cat playing with a lizard.jpg | Cat playing with a lizard
| Felis silvestris catus lying on rice straw.jpg | Cat lying on rice straw
| Mumbai 03-2016 63 Dhobi Talao Chowk.jpg | Cats in Mumbai
| File:Felis catus-cat on snow.jpg | Cat on snow
| Tired 20-year-old cat.jpg | Tired cat
}}
{{Box-footer}}

Selected pictures

Mice

{{Random slideshow | width=275
| File:Agouti Mice.jpg | Two mice | credit1= Photograph: Pogrebnoj-Alexandroff
| Brown mouse.jpg | Brown mouse | credit2= Photograph: [[User:Kulmalukko|Tiia Monto]]
| File:Farbmaeuse.jpg | Mice with food | credit3= Photograph: [[c:User:Whitesky~commonswiki|Whitesky]]
| File:Farbmaus.JPG | Mouse on a wheel | credit2= Photograph: [[de:User:R2Dine|R2Dine]]
| White lab mouse in hand B.jpg | A mouse in the hand is worth two in the bush | credit4= Photograph: Pogrebnoj-Alexandroff
}}

TemplateData

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for Random slideshow

Creates a slideshow gallery with randomized order. Add as many images as desired.

Template parameters

This template prefers block formatting of parameters.

Parameter		Description	Type	Status
Image 1	1 (unnamed positional parameter)	Name of the first image, without prefix Default (empty) Example Portal puzzle.svg, 1=Portal puzzle.svg	File	required
Caption 1	2 (unnamed positional parameter)	Caption of the first image Default (empty) Example 2=This is the default portal icon	String	required
Credit 1	credit1	Credit for the first image Example Photograph: [[User:Example|Example]]	Unknown	optional
Width	width	Maximum width of all images Default (none) Example width=80px, width=30em, width=50%	Number	suggested
Image 2	3 (unnamed positional parameter	Name of the second image, without prefix Default (empty) Example Brown mouse.jpg, 3=Brown mouse.jpg	File	suggested
Caption 2	4 (unnamed positional parameter)	Caption of the second image Default (empty) Example 4=This is a brown mouse	String	suggested
Credit 2	credit2	Credits for the second image Example Photographer: [[User:Example|Example]]	Unknown	optional