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.

{gliffy:name=My UML Diagram}

{gliffy:name=My UML Diagram|size=M|align=right}

{gliffy:space=Software|page=User flow|name=My user flow drawing|size=T|align=center}

{gliffy:space=Software|page=User flow|name=My user flow drawing|size=T|align=center|version=3}

Includes a Gliffy diagram in the page.

  • name - (required) The name of the diagram. This name must be unique for the current page.
  • space - (required if page attribute used, otherwise optional) The space key of the page that the diagram is attached to.
  • page - (required if space attribute used, otherwise optional) The name of the page that the diagram is attached to.
  • pageid - (optional) The id of the page the diagram is attached to (alternative to specifying the space and page name).
  • size - (optional, default is L) The size of the image that will be shown. Possible values are L (Full size), M (medium), S (small), T (Thumbnail)
  • align - (optional, default is left) Horizontal alignment of the diagram image on the page. Possible values are left,center, and right.
  • alt - (optional, default is diagram name) Image tag alternative text.
  • border - (optional, default is true) Display the border around an image.
  • version - (optional) The version of the diagram to display. If this attribute is not defined, the latest version of the diagram will be displayed. NOTE: When updating a diagram, the version number will be updated in each macro ONLY on the page that contains the diagram attachment.



{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.