The Gallery Macro displays a gallery 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 the full-size image and then view the images as a slide show. See below for instructions on how to add the gallery macro to your page. The gallery macro appears as in the screenshot below.
| On this page: |
Screenshot: The Gallery Macro in Confluence
Using the Gallery Macro
To insert the Gallery macro into a page:
- In the Confluence editor, choose Insert > Other Macros.
- Find and select the required macro.
Parameters
When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.
Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser.
The full list of parameters is shown in the following table.Parameter | Default | Description |
---|---|---|
Gallery Title | Nothing | Specify a title for your gallery. |
Number of Columns | 4 | Specify the number of columns for your table. |
Images to Exclude | No exclusions i.e. include all the pictures on the page. | The gallery will ignore any pictures specified. You can specify more than one picture, separated by commas. |
Include these Images Only | 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. |
Use Images in these Pages | 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. To specify a page in a different space, use the SPACEKEY:Page Title syntax. |
Sort Images By | None, i.e. 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:
|
Reverse Sort | Off, i.e. sort order is ascending | Used in conjunction with the Sort Images By parameter above. Use Reverse Sort to reverse the sort order, from ascending to descending. |
![]() | If the name of an attached file or page contains a comma, you can refer to it in the relevant parameters above by enclosing it in single or double quotes, for example |
![]() | Considerations for using the gallery macro
|
Related Topics
Displaying Images
Attaching Files to a Page
Editing Attachment Properties
Working with Macros
Take me back to the Confluence User's Guide.
Attachments:







