Notation Guide

Print Help Tips

Images can be embedded into Confluence pages from attached files or remote sources.

Notation Comment
Inserts an image into the page.

If a fully qualified URL is given the image will be displayed from the remote source, otherwise an attached image file is displayed.


!/2007/05/23/My Blog Post^image.gif!
Inserts an image that is attached on another page or blog post.

If no space key is defined, the current is space is used by default.


Insert a thumbnail of the image into the page (only works with images that are attached to the page). Users can click on the thumbnail to see the full-sized image.

Thumbnails must be enabled by the site administrator for this to work.

!image.gif|align=right, vspace=4!

For any image, you can also specify attributes of the image tag as a comma separated list of name=value pairs like so.



{gallery:title=Some office photos, and a waterfall|columns=3}

{gallery:title=Some office photos, without the waterfall|exclude=waterfall.jpg}

{gallery:title=One office photo, and a waterfall|include=office1.jpg,waterfall.jpg}

{gallery:title=Some office photos, and a waterfall|page=Gallery of Pictures}

{gallery:title=Some office photos, and a waterfall|page=DOC:Gallery of Pictures}

{gallery:title=Some office photos, and a waterfall|sort=name}

{gallery:title=Some office photos, and a waterfall|sort=date|reverse=true}

Create a gallery of thumbnails of all images attached to a page. This will only work on pagesthat allow attachments, obviously.

The title parameter allows you to supply a title for the gallery

The columns parameter allows you to specify the number of columns in the gallery (by default, 4)

The exclude parameter allows you to specify the name of attached images to ignore (i.e., they will not be included in the gallery). You can specify more than one picture, separated by commas. Example: exclude=my picture.png,my picture2.gif

The include parameter allows you to specifically include one or more attached images. The gallery will show only those pictures. You can specify more than one picture, separated by commas. Example: include=my picture.png,my picture2.gif

The page parameter allows you specify the title of one or more pages which contains the images you want displayed. If a page is in the same space as the page containing the macro, use the format page=My Page Name. To specify a page in a different space, use page=SPACEKEY:My Page Name, such as page=DOC:Gallery Macro. You can specify more than one page, separated by commas. Example: page=Image Gallery,STAFF:Group Photos

If a page or attachment file name contains a comma, you can use it in the include, exclude, or page parameters by enclosing it in single or doublequotes. Example: include="this,that.jpg",theother.png

The sort parameter allows you to control the order of the images. The options are name,comment, date, or size.

The reverse parameter is used in conjunction with the sort parameter to reverse the order of the specified sort. Valid values are true and false.

Previous versions of the Gallery macro had an additional slideshow parameter. This is no longer used in the latest version, and the slide show is always enabled. We have left the parameter here for compatibility with older versions of the macro.

{map:link=[myTarget]| coords=257,174,363,233| title='Jump to Target'| shape='rect'}

{imagemap} Base-Plugin defining the image to use for the ImageMap.

  • name: (mandatory) Specifies the link to the image to be used as an ImageMap. Can be
    1) an absolute URL e.g. '[]' or
    2) a Confluence-like link to an image-attachment [somepage^somepicture.jpg]

{map} Nested Plugin for defining clickable regions and target-links.

  • title: (optional) Tooltip text, that appears if the mouse stays over the clickable region.
  • coords: (mandatory) Coordinates of the shape:
    x1,y1,x2,y2 for rect-shapes
    x,y,r for circle-shapes
    x1,y1,x2,y2 ... xn,yn for polygon-shapes.
  • link: (mandatory) Target link where to go, after region was clicked.
    Can be
    1) an absolute URL e.g. '' or
    2) a Confluence-like link [somepage]
  • shape: (optional) The shape of the clickable region. Possible values are 'rect', 'circle' and 'polygon'. Defaults to 'rect'