The Tooltip macro is a simple plain text macro that adds a dynamic icon element anywhere on a Confluence page. Simply add the text that you want to display to users when they hover over or click the Tooltip icon. This is useful for annotations, definitions, acronyms, or anywhere where you want to include additional detail without taking up precious space or impacting the design of your page layout.

Tooltip is available only in Confluence Cloud’s new editor and therefore cannot be used with migrated content.

Instructions

  1. Navigate to the page you want to edit.

  2. Click the Edit icon.

  3. Click where you want to add the Tooltip icon, for example, to the right of an acronym.

  4. Click Insert > View More.

  5. Select the Tooltip macro in the Select Macro screen.

    The Edit screen for a Tooltip macro.
  6. Enter the text that you want to display then click Save. A macro placeholder is displayed.

  7. Click Publish to see the tooltip rendered on the page. Test the tooltip by hovering your cursor over the blue icon, or click it to display a pop-up.

    A rendered example of a working Tooltip macro.

Tooltip on hover

An example of Tooltip text displayed when the cursor hovers over the Tooltip icon.

Pop-up when clicked

An example of the Tooltip macro, where text is displayed after the Tooltip icon is clicked.

On mobile touch devices, users should tap the icon to display a pop-up containing the tooltip text.