Skip to main content
Skip table of contents

Add captions to Images, Figures, and Tables


You can use the Scroll Title macro to add captions to images, figures, and tables in exports. Those captioned elements can then be referred to from an index, like a table of figures, or table of tables. To use the macro, insert it into a page, highlight it and then select Edit. You can then enter the caption title you want to assign to the content and after confirming, move that content into the macro. You must wrap each element you want to caption in a separate Scroll Title macro.

If you don't define a caption title within the macro, this error message will be printed in the Word export: Error rendering macro 'scroll-office-title': com.atlassian.renderer.v2.macro.MacroException: Parameter named 'title' is missing

Linking to captions

By editing an inserted Scroll Title macro you can also associate an anchor element which can be linked to. Any links to the anchor element for the caption will be preserved in the Word export. 

To do this, simply select Edit after inserting the macro to a page and then define the text for the anchor in the Anchor Name field. Following this, you can then add a link to the same Confluence page and/or a page in the same space which directs to the anchor for the caption. For more information about adding Anchors in Confluence please see their documentation

Adjust caption position and alignment 

After adding the desired caption to your figure you can also customize the placement and alignment of the caption.

With the macro parameter title-position, you can decide whether you want the caption to appear above or below the table or figure. Additionally, the title-alignment macro parameter allows you to define the alignment of the caption text. You can choose between the alignments: Left, Center, Right and Justify.

The Justify alignment differs from the other directional alignments and allows you to write longer captions, on several lines, in a good looking way. The letter- and word-spacing gets aligned so that the caption text stays within a predefined squared structure.

Please note that the caption alignment in exports is always taken from the template.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.