Content Formatting Macros for Confluence Cloud


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 whenever 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.


  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. 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.


Tooltip on Hover


Pop-up When Clicked


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