Footnotes is a pair of macros that allows you to insert and display footnote entries on a Confluence page. Use the Footnote macro to define your footnote content then display your footnotes in a list using the Footnotes Display macro. The Footnotes Display macro lists all the footnotes that occur above it in your Confluence page. You can use it to list all footnotes at the bottom of the page, or to group footnotes in specific sections of the page.


Footnote macro

  1. Navigate to the page you want to edit.

  2. Click Edit.

  3. Click the position where you want to add a footnote, e.g. next to a word or at the end of a line of text.
  4. Click Insert More Content Other Macros.

  5. Select the Footnote macro from the Macro Browser.

    The Macro Browser with the Footnote macro available.
  6. Click Insert. The Footnote macro placeholder displays.

  7. Enter the content to display as your footnote reference, e.g. from 2002 census dataThis can include text, images or other media. 

  8. Add further footnotes as required and save your page. Each Footnote macro displays an inline marker which links to the same number or reference within the Footnotes Display macro. On hovering over a footnote marker, the content of the footnote is shown in a preview box.

    Footnote content preview
    An example of how a Footnote macro displays an image, when saved and rendered.

Footnotes Display macro

Once you have added your footnotes, insert the Footnote Display macro to render a list of references on your page. This can be added to the bottom of your page to include all references, or after a specific section of your page to include only the references above it. In both cases, the Footnotes Display macro must be positioned below the footnotes you want to display.


The example below represents a page with several Footnote macros, each with different content types or styling.

Footnote formatting in Edit viewRendered Footnote Display

A Confluence page, in Edit mode, with several Footnote placeholder macros.

The saved and rendered Confluence page from above.

Cross-referencing footnotes

If the same footnote content is used for multiple references, these are collated in the footnote display and the same footnote number is assigned to the reference.

Footnote formatting in Edit viewRendered Footnote Display

A Confluence page, in Edit mode, with Footnote placeholder macros in a cross-referencing example.

The saved and rendered Confluence page from above.

Export to PDF or Word

Pages with footnote macros are exportable in both PDF and Word formats retaining all of the footnote formatting and related links. To export your page, select the required export option (PDF or Word) from the Ellipses menu in the top right of your Confluence page. The following example illustrates the rendering of footnotes exported to PDF.

A page with Footnote macros in Confluence.

The Confluence page from above, exported as a PDF (footnotes are retained).

Limitations for Mac

If using Microsoft Word for Mac to view an exported Word document, the footnote links return users to the top of the page, not the corresponding place in the document. Additionally, the in-line footnote links do not return to the corresponding footnote.