For Cerner’s support and commitment to our clients regarding COVID-19, see the Cerner COVID-19 Response Center page on Cerner.com to access Cerner Recommendations, FAQs, and Lessons From the Field and visit the COVID-19 Client Collaboration Forum to ask questions and share experiences.
uCern is migrating to a new platform effective May 4, 2021 There will be no downtime. Cerner Wiki is not impacted by this migration.
uCern Help


Cerner Wiki Help

uCern Help

uCern System Requirements

Child pages
  • Gallery Macro
Skip to end of metadata
Go to start of metadata
The version of this page that you are viewing is the most current, approved content.

The Gallery macro displays a collection of thumbnail images in a table, based on the images attached to a Confluence page. When viewing the page, a user can click a thumbnail image to zoom into a screen-sized image and then view the images as a slide show.

Overview:

  • The images shown in the gallery are taken from the files attached to the Confluence page. You can also specify a different page where the attachments are located. For information about attaching images to a page, see Upload Files.
  • The captions below the images are drawn from the comments on the attachments. For information about adding comments to attachments, see Upload Files.
  • By default, the gallery will include all the images attached to the page. You can also exclude or include images using parameters.
  • You can sort your images into a particular order.
  • You can specify a title for the gallery and also configure how many columns you want for the table in which your images are displayed.

Illustration: Live example of the Gallery macro

 

   
   
 
   

 

Using the Gallery macro

To insert the Gallery macro onto a page:

  1. From the editor toolbar, choose (Insert) > Other Macros
  2. Find and select the required macro

Speed it up with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. In this example we're inserting the cheese macro.

To edit an existing macro: Click the macro placeholder and choose Edit. This will open the macro details, so you can edit the macro parameters.

Parameters

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).  

The full list of parameters is shown in the following table. If the name of an attached file or page contains a comma, you can refer to it in the relevant parameters below by enclosing it in single or double quotes, for example "this,that.jpg", theother.png

 

Parameter

Default

Description

Gallery Title
(title) 

Nothing

Specify a title for your gallery.

Number of Columns
(columns) 

4

Specify the number of columns for your table.

Images to Exclude
(exclude) 

No exclusions. Include all the pictures on the page.

The gallery will ignore any pictures specified. You can specify more than one picture, separated by commas.
Note: The filename and filetype for this parameter are case-sensitive. For example, 'my picture.PNG' will not be recognized as 'my picture.png'.

Include these Images Only
(include) 

Include all the pictures on the page.

If you specifically include one or more pictures, the gallery will show only those pictures. You can specify more than one picture, separated by commas.
Note: The filename and filetype for this parameter are case-sensitive. For example, 'my picture.PNG' will not be recognized as 'my picture.png'.

Exclude Images with these Labels
(excludeLabel) 

No exclusions. Include all the pictures on the page.

The gallery will ignore any pictures that have the specified label. You can specify more than one label, separated by commas. For information on labeling the attachments, see Add, Remove and Search for Labels.
Include Images with these Labels Only
(includeLabel) 		None. The images are not filtered by label.Filters the images to display, based on a list of labels. If you wish to enter more than one label, separate the labels with commas. Confluence will show only images that have all the labels specified. (The match is an AND, not an OR.) For information on labeling the attachments, see Add, Remove and Search for Labels.

Use Images in these Pages
(page) 

If no page is specified, the gallery macro displays the images attached to the page on which the macro is used.

Specify the title of the page which contains the images you want displayed. You can specify more than one page name, separated by commas. To specify a page in a different space, use the following syntax: SPACEKEY:Page Title

Sort Images By
(sort) 

None. The sort order is unspecified and therefore unpredictable.

Specify an attribute to sort the images by. Sort order is ascending, unless you select the Reverse Sort parameter (see below). Options are:

  • name – file name.
  • comment – comment linked to the attached file.
  • date – date/time last modified.
  • size – size of the attached file.

Reverse Sort
(reverse) 

Off. Sort order is ascending

Used in combination with the Sort Images By parameter above. Use Reverse Sort to reverse the sort order, from ascending to descending.

Available values in storage format and wikimarkup:

  • true – Sort order is descending.
  • false – Sort order is ascending.

 

Image file formats

 

You can attach image files of any format to a page. Confluence supports the following image formats in the Gallery macro and when displaying an image on a page:
  • gif
  • jpeg
  • png
  • bmp (depending on browser support)