Get the high-level details you need to set up your Confluence Cloud site in order to meet your team's needs.
Learn how to create great content and organize it.
Learn how to collaborate on pages and blogs, get notified about activity, and view analytics to see how content is performing.
Adjust settings around who can see what content on your site and what actions they can perform on it.
Find everything a site admin needs to know to keep their Confluence Cloud site running smoothly.
Get an overview of all the ways you can extend your Confluence content using macros and gadgets.
This macro was intentionally excluded from the new editor and will be deprecated from the legacy editor soon.
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.
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.
Use the Gallery macro
To add the Gallery macro:
When editing , select from the toolbar
Find the item to be inserted and select it
You can also type / on the page to bring up the same list you'd see by selecting from the toolbar.
To edit the Gallery macro:
Select the macro placeholder. The floating toolbar appears.
Select Edit. The right panel opens.
Modify the parameters. Your changes are saved as you go.
Resume editing the page, and the panel closes.
Parameters are options that you can set to control the content or format of the macro output.
If the parameter name used in Confluence Cloud storage format or wikimarkup is different than the label used when inserting macros using the browser or the slash command, 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
Specify a title for your gallery.
Number of Columns
Specify the number of columns for your table.
Images to 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.
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.
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
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 Use labels to organize pages and attachments.
Include Images with these Labels Only
None. The images are not filtered by label.
Filters the images to display, based on a list of labels. Separate multiple labels with commas. Confluence will show any image that has at least one of the labels you specify (it's an OR match as opposed to an AND).
For info on labeling attachments, see Use labels to organize pages and attachments.
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. 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
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:
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:
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:
bmp (depending on browser support)
Wiki markup example
Wiki markup is only supported in the legacy editor.
Wiki markup is useful when you need to add a macro outside the editor, for example as custom content in the sidebar, header or footer of a space.
Macro name: gallery
Macro body: None.
Was this helpful?