Your Confluence pages, but better
Give your Confluence pages the love they deserve. Discover Mosaic today and start building pages that users care about.
4 ways to highlight text in Confluence Cloud
Share on socials
4 ways to highlight text in Confluence Cloud
Jump to Section
Jump to section
Why highlight content on your Confluence page?
How to highlight Confluence text
Option 1: Highlight colour feature
Option 2: Inline comments
Option 3: Panel macro
Option 4: Background macro
TLDR
Unsure how to make your Confluence content stand out? Here are four easy ways to highlight text in Confluence (and when to use them).
Are users missing the key points in your Confluence pages? Are you struggling to make important messages stand out? There's an easy way to make your Confluence content more engaging - highlight it!
Why highlight content on your Confluence page?
Highlighting text is a simple but effective way to draw attention to specific parts of your page, helping you to:
- Emphasise information: help readers notice and absorb important information.
- Boost readability: break up blocks of text and make content more visually appealing.
- Improve navigation: highlight text in different colours to help users understand what's crucial, secondary, and optional.
- Easily flag errors and issues: let readers know if a page is outdated or under construction, or flag broken links or inaccurate information for page admins to fix.
How to highlight Confluence text
With the help of Confluence macros and built-in features, it's easy to make important messages stand out.
Option 1: Highlight colour feature
Best for: Quick and easy highlighting on internal (employee-facing) Confluence pages
Make messages pop with Confluence's built-in highlighting tool
A fairly new feature for Confluence Cloud, it's quick and simple to make your text stand out. Simply:
- Select your text.
- Click the Text and Highlight Colour option in the toolbar.
- Choose from one of seven colour options.
Benefits:
- You can highlight text in a few colours, which helps to add context (e.g., highlight text in yellow or orange to suggest a warning/caution).
- It's built-in and easily accessible from the Confluence Cloud toolbar.
Limitations:
- It's not particularly suitable for highlighting text on customer-facing content, as it doesn't look very professional.
- Highlighting large amounts of text in this way can be overwhelming to read.
Option 2: Inline comments
Best for: Adding quick memos or collaborating with teammates on internal documents.
Inline comments highlight text and boost collaboration
Need to quickly draw attention to text that needs to be changed? You can do exactly that with an inline comment.
To highlight text inline with a yellow box:
To highlight text inline with a yellow box:
- Click and drag over your chosen text, then click Comment.
- Type in the comment box and press Save.
Benefits:
- Highlighting is quick and easy, with no macros needed.
- Anyone can highlight text, even if they don't have permission to edit the page.
Limitations:
- Highlighting lots of text clutters the page with comments, making it harder to read.
- It can look unprofessional, especially on external or customer-facing pages.
- It's temporary - the text is only highlighted while your comment remains unsolved.
Option 3: Panel macro
Best for: Adding callout boxes for important hints, notes, and warnings.
Configure the Panel macro to fit the context of your message
The Panel macro is a great way to highlight important notes that give extra context. Though the macro comes in six pre-made choices (such as 'Success Panel' and 'Error Panel'), you can customise any of them with a range of background colours and icons.
Benefits:
- Can be customised with several background colours and icons (including emojis) to highlight text in a more eye-catching way. It’s also possible to change the text colour.
- You can add text on multiple lines, making it useful for longer messages.
- It's possible to change the size of text with the Text Styles dropdown menu, which means you can add a heading.
Limitations:
- The background is limited to 21 shades, which isn't ideal for Confluence pages with company branding.
- The panel automatically scales to the width of your Confluence content, meaning text can look lost if the message is short.
- You can’t embed media, making it unsuitable for messages with images.
Option 4: Background macro (from Mosaic)
Best for: Making Confluence content infinitely more engaging and creating stand-out sections on branded pages
The Background macro can improve visual appeal and make navigation easier
The Background macro is one of several macros included in Mosaic: Content Formatting Macros & Templates. It isn't just great for highlighting text but also for adding visual structure to your content, transforming a flat page into a striking knowledge base, team page, intranet, and more. The powerful editor gives you the tools to highlight text and other embedded content in any way you want.
Benefits:
- An incredibly versatile macro that lets you highlight content any way you want.
- The only solution that lets you highlight text and other content, such as images, a search bar, buttons, and numbered headings.
- Highlight with any colour or upload an image instead (you can even use Pexels' built-in library to find one that fits your theme).
- Choose custom dimensions - whether you want a tiny callout box or a striking banner, you can achieve both.
Limitations:
- As it's an external app, you need admin permissions to install it on your Confluence instance.
- For teams of more than 10, the app is paid (annually or monthly). The good news is you can try it free for 30 days with access before you make a commitment.
TLDR;
There are several ways to highlight text on your Confluence page, but how you do it depends on what you want to achieve. So, to summarise:
- Highlighting text on internal-only pages? ➔ Use the Highlight colour feature.
- Collaborating on content or flagging an issue with text? ➔ Use Comments.
- Adding a little context or a warning to the page? ➔ Use the Panel macro.
- Looking to highlight pages without limitations? ➔ Use the Background macro from Mosaic.
With Mosaic, you can do so much more than highlighting text. From Advanced Cards to Tabs, you'll have the macros to make immersive pages that users read and remember.
Related Content
Read more
Written by
Related Content
Read more