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.

Add a Tooltip macro to your page

  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.

  6. Enter the text that you want to display then click Save.

  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

There is a small delay on hover, before the tooltip appears.

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.

Video Walkthrough

Watch our video walkthrough to see the Tooltip macro in action.

Related Macros

On this page