Footnotes and Tooltips

Footnotes are superscript numbers (1) placed within the body of text and collected at the bottom of a page. They can be used for two things:

  1. As a citation

  2. As a provider of additional information.

A tooltip is a message that is displayed when a user hovers over or clicks on UI elements such as an icon, a highlighted word, or a button. Tooltips are short messages related to specific UI elements that provide additional explanations and guide users toward taking specific actions.

Tooltips are best when they provide additional explanations for an unfamiliar form to some users or reasoning for what may seem like an unusual request.

Include additional information without distracting the reader from the main text.

Try to keep the explanation message short and understanding. Using many and long tooltips can distract users from the main content.

How to use

Please follow these steps to insert a Footnotes and Tooltips macro on a Confluence page:

  1. Navigate to the Confluence page you wish to edit or create a new page.

  2. Once in edit mode, either click the plus icon in the navigation bar (insert elements) or press '/' on your keyboard to bring up the macro list.

  3. Type "Optics" in the search bar, then choose the Footnotes and Tooltips macro from the options displayed.

When the configuration dialog opens, it guides you through customizing your button, with a live preview showing changes in real-time. Once you're satisfied, click Save to add the button to your Confluence page. If you decide not to proceed, clicking Cancel will cancel the setup without inserting the macro.

Footnotes or Tooltips

Choose between tooltips and footnotes.


Choose a colour from the predefined colour set .


Add description that will show on hover or as a notification banner.

Footnotes display macro

If the page contains footnotes, it is required to use footnotes display macro.