Skip to Content

Confluence Gallery Macro

Last modified by Jim Bach on 2026/07/01 12:24

Description

The Confluence Gallery macro is a bridge between Confluence and XWiki. This bridge uses the XWiki implementation of the Gallery amcro under the hood and therefore assumes that the Confluence gallery macro is prefixed during import. There are two things to note:

Only a subset of the parameters supported by the Confluence macro are supported by this bridge macro: title, exclude, include and page. The remaining parameters are ignored:

  • columns does not make sense for the XWiki macro as the images are displayed differently
  • excludeLabel and includeLabel are not supported since XWiki does not support attachment tags
  • sort and reverse have not been implemented in this bridge macro

Parameters

ParameterDescriptionRequiredDefault
titleTitle of the gallery.No 
excludeExcluded images (comma separated).No 
includeIncluded images (comma separated).No 
pagePages containing the images to display. Current page if empty.No 

Examples of usage

All images of current page

{{confluence_gallery/}}

The result is the following :

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

img1.png
img2.png
img3.png

Exclude one image

{{confluence_gallery exclude="img1.png"/}}

The result is the following :

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

img2.png
img3.png

Include two images

{{confluence_gallery include="img1.png,img3.png"/}}

The result is the following :

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

img1.png
img3.png

All images of the Sandbox page

{{confluence_gallery page="Sandbox" title="Sandbox images"/}}

The result is the following :

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Sandbox images

XWikiLogo.png