Skip to end of metadata
Go to start of metadata

 The Footnote and Display-Footnotes macros allow you to easily create footnotes in your content...

Define footnotes within your content using the Footnote macro.

A marker will be shown to indicate where there are footnotes and clicking on this icon will take you to the displayed footnote further down the page.

Use the display-footnotes to output all currently unlisted footnotes from the content above. Each footnote is listed alongside it's corresponding numbered marker and you can click that marker to return to your previous position in the content above.

The macros have been designed with maximum usability and accessibility in mind. They do not require JavaScript, although they will be more interactive if it is enabled. The footnotes are designed to be easily recognisable in print, email and page exports (Word and PDF), as well as being easy to create and use when viewed in a web browser.

Top of page


To define a footnote on page anywhere within your content or display-footnotes usually at the bottom of a section, use the following notation which will populate your page with macro options.

You can also choose to open your macros using macro editor.


You can also use macros to define a footnote anywhere within your content and to display a list of footnotes, usually at the bottom of a section or page.

Top of page

Basic Use


To create a marker for a simple text-only footnote use the following format:

Display footnotes below the point where you defined the footnote marker:

Which results in:

When you click the footnote marker, the corresponding footnote will be highlighted in the display further down the page. To return to the content above, click the marker within the footnote display.

Top of page

Links in Footnotes

There are times when you may want a footnote to refer to another web page, to do this simply add a link to your footnote:

Be wary of displaying the list of footnotes within a tabbed panel as we are doing here - the tab that displays the footnotes (in this case "Example 4") will not automatically be selected.


Display footnotes below the point where you defined the footnote marker:


Which results in:

Top of page

Images in Footnotes

You can use images in footnotes: 

Images sometimes don't display properly if you export the page as Word or PDF format, and they sometimes don't work when the page is emailed (eg. when watching a page).

Top of page

Multiple Footnote Lists

Normally, you'll just want to list the footnotes at the end of a document (similar to what we showed in Example 1), however you can display more than one list of footnotes if desired: 

Which results in:

As you can see, each time you use the display-footnote macro it lists out all the footnotes that haven't already been listed. This is ideal for creating section-level footnotes, etc.

Top of page

Cross Reference Footnotes

You can insert the same footnote in the text multiple times without creating a duplicate Footnote, and the original footnote will be referenced at multiple locations in the page.

Text with multiple Footnotes

You can insert more than one footnote for a particular text


1. We do not offer compatibility of Footnotes with any External plugin macros. 

2. Footnotes macros are compatible with standard Confluence macros when they are placed in the same Confluence page but not when they are placed one inside the other.


Top of page

 Hints and Tips
Hints and Tips

When reading footnotes, you can mouse-over the icon to the side of them to highlight them and put a box round them.

When you define a footnote 1 , check the page after saving to ensure that it's being displayed.

It's generally a good idea to include the {footnotes} macro at the bottom of any page that defines footnotes - should content be moved around at a later date, the list at the end of the page will display any stray footnotes.

You can use footnotes to display references to publications, etc. Simply format the content of the footnote to get the desired effect (eg. using italic text and bold text to highlight author, publication name, etc).

If footnotes are displayed quite far away from their markers, try to include additional information so the reader can work out what they relate to without reading the content around the marker. For example, which of these makes the most sense:


This doesn't work in Internet Explorer unless you are using our theme.


Internet Explorer (versions 5 and 6) doesn't properly support transparency in PNG images. You can fix this problem by using our Builder theme.

If you include an image in your footnote, the layout can sometimes look a bit messy. For example:

This footnote contains an image 

As you can see, the text is centred against the image and in Example 4 it makes the footnotes look messy.

To get around this problem, set the image alignment as follows:

 This footnote contains an image !cubes.png|align=top!

Resulting in:

This footnote contains an image 

Top of page





  • No labels