Confluence

Overview:

The {gallery} macro allows you to display a thumbnail image gallery on a page...

Although you can manually display images on a page, it can be a real pain if you have lots of images - this macro allows you to add a thumbnail image gallery to a page in seconds that shows all image attachments. When a thumbnail image is clicked, the corresponding full size image will be shown.

Parameters:

To add a gallery to your page, use:

{gallery:columns=x|title=whatever}

Parameter	Required	Default	Notes
columns		4	The number of columns to use in the thumbnail gallery.
title			A custom title to display at the top of the gallery.

Examples:

Simple Use

Quickly add a gallery to a page:

{gallery}

Resulting in:

	Tuba	Violin	Drum Kit
Bass	French Horn

In many cases, the default 4 column display as shown above will result in horizontal scrolling (if using the default 200px thumbnail size) on smaller screen resolutions - this will annoy people!

Navigate to the next example to find out how to reduce the number of columns and avoid unsightly layouts.

Number of columns

Generally, it's worth restricting the gallery to three columns as shown below:

{gallery:columns=3}

Resulting in:

	Tuba	Violin
Drum Kit	Bass	French Horn

Custom title

Add a custom title to your gallery as follows:

{gallery:columns=3|title=Musical Instruments}

Resulting in:

Musical Instruments
	Tuba	Violin
Drum Kit	Bass	French Horn

Centering the gallery

When using 3 columns, it generally looks nicer if you use the center macro to center the image gallery on the page:

{center}{gallery:columns=3|title=Musical Instruments}{center}

Resulting in:

Musical Instruments
	Tuba	Violin
Drum Kit	Bass	French Horn

It's a small touch, but makes the page look so much nicer - compare the gallery shown above to that shown in Example #3.

Hints and Tips:

When uploading image attatchments, always give them a description - as you can see in the examples above, our Piano didn't have a description so it was the only image in the gallery not to show the instrument name below the picture.

For Builder themed accounts set to the standard 750px page width, the default display may force the page width to extend beyond the specified width - to get round this problem, either:

• Use 3 columns in the gallery
• Set the thumbnail size to 150px if you want to use 4 columns
• Set the Builder page width to 100%

This macro shows images in the order they were uploaded - with the most recent images first. If you want to change the order of the images, the only way we are currently aware of is to re-upload images to move them to the top of the display, although this is a bit of a fudge, obviously!

Many modern browsers allow you to right-click an image to get it's URL - it's not recommended to do this with images in the gallery because they are referenced by index and as such if images are added and removed at a later date that index could end up pointing to a different image.

Frequently Asked Questions:

See Also:

• Linking to Attachments
• Altassian's online documentation