Skip to main content
How to add hints and tips with a Confluence tooltip
Share on socials

How to add hints and tips to your page with the Confluence Tooltip macro?

A headshot of Zoriana Bogutska
Zoriana Bogutska
29th January, 2024
A teal speech bubble beside a lightbulb
A headshot of Zoriana Bogutska
Zoriana Bogutska
29th January, 2024
jump to section
What is a Confluence tooltip?
How to add the tooltips to a Confluence page
What are Confluence tooltips used for?

Let’s talk Confluence tooltips, and how they can help you provide extra information to keep everyone in the know.

Sometimes, a concept needs more explanation than is wise to give within the text itself. If you want to add extra term definitions or user guidance without derailing the flow of your text, you can do just that with a Confluence Tooltip.

To use tooltips, you’ll need to have Content Formatting Macros for Confluence Cloud installed. Install it free for up to 10 users.

What is a Confluence tooltip?


A tooltip appears on your Confluence page as the letter ‘i’ in a blue circle next to some text. When a user hovers their cursor over the tooltip, a dialog box will appear containing an explanation of the text, or more information that may be useful to the user. The user can click on the tooltip to bring up a larger pop-up with the same text.
Some text in Confluence with a tooltip giving the definition of an API

How to add the tooltips to a Confluence page


1. Install Content Formatting Macros for Confluence (you can try it free for 30 days!)
2. Go to the page you want to add the tooltip to. There, click Edit.
A Confluence page with the Edit button circled
3. Click on the text you want the tooltip to appear next to. For example, an acronym that users may not be familiar with. Type the /tooltip shortcut and select the Tooltip macro.
GIF of a user typing in the tooltip shortcut and selecting the tooltip macro
4. Type in the text you want to appear when a user hovers over or clicks on the tooltip. Then click "Save".
The tooltip editor dialog containing text that will show in the tooltip
6. Select "Publish" or "Update" in the top-right of the Confluence page to see your tooltip as it will appear to users.
A user hovering over a Confluence tooltip to reveal its text

What are Confluence tooltips used for?


Tooltips give you at-a-glance context and information and have 100s of potential use cases. Here are some ideas for when you might want to add a Tooltip in Confluence:
  • Explain terms and acronyms - add definitions to make instructions and information clearer.
  • Form input guidance - let users know what kind of answer you expect within a form field.
  • Updates and changes - signpost any changes that have been made since previous versions of the text, or a change to something referenced within the text.
  • Tips for troubleshooting - for things that often cause confusion - or often lead to issues - offer a tip to overcome this!

Enhance your Confluence pages with tooltips and much more

Click below to try Content Formatting Macros for free today.
Written by
A headshot of Zoriana Bogutska
Zoriana Bogutska
Senior Product Marketing Manager
Zoriana has over 12 years of experience in marketing, with 6 of them in product marketing management. As a Senior Product Marketing Manager, Zoriana aims to ensure Kolekti's apps excel by understanding customer needs, solving their problems, and making Kolekti truly the best solution.

LinkedIn →
Confluence
Content Formatting