The 5 Best Ways to Highlight Text in Confluence

This guide dives into various methods, from status macros to third-party options, to make your text stand out. Read how!
Picture of Tim Böhmer

Tim Böhmer

Table of Contents

We know every word in every piece of content you craft is important. If it wasn’t, why else write them? Many times, though, some of those words and phrases are just slightly more important than the others, and you want to set those apart and draw attention to them specifically. 


And that’s what we mean by highlighting in this article’s context. It’s not just the formatting tool that mimics placing a brightly colored band over text as such, but also the formatting tools within Confluence we use that otherwise call attention to and suggest “you might want to pay particular attention to this!”

Confluence Techniques and Tools to Highlight Text

If you’re looking for a quick way to start a heated discussion among Confluence users, inquire about the best way to highlight text on the platform. If it were for purposes just as simple as shown above — to give the most basic visual formatting cue of highlighting, that’d be one thing —  but there are other reasons to want to emphasize specific portions of content;


  • Navigation — help lead your readers through your content 
  • Identify — distinguish sections of text or entire pages as to its status or that may need additional attention
  • Readability — “chunk” or group sections of text


Let’s start with highlighting via an identification method, in this case, we’ll describe how to use Confluence’s macros to indicate a status or priority level.

Mark Text Using Status 

When you boil it down, if you’re a Confluence user, you’re most likely part of a team, and being part of a team means you’re dealing with deadlines and due dates.

add status macro to confluence


There are two ways you can add a status or priority highlight to a page. The first is when you’re at the title for the page in Edit mode. In the example above, you’ll see we’re positioned at the start of the page and when at the page title, the menu presented offers a status option. You can choose from the drop-down there. 

If you’re further within the body of the Confluence page, simply call the Status macro in edit mode by typing the backslash / and then status. You can then select one of five colors to customize and name it either as a status, a priority, or whatever you’d like. Once complete, the Status macro will appear on a Confluence page to highlight the status.


add status macro to confluence

Color Me Highlighted

One of the easiest and fastest ways to highlight words or sections of text content and make them stand out is to simply select them in Edit mode, and choose a different color. While certainly not the most prominent way to call attention, this can be an effective way to break up the flow of text and white space with a splash of color to draw the reader’s attention.



Confluence Panel Macro


Confluence’s included Panel macro offers six different types to choose from; 


  • Info 
  • Note 
  • Error 
  • Custom 
  • Success 
  • Warning
confluence panel macro


These panels appear as colored blocks or texts/backgrounds where text and other content can be displayed, each offering a level of customization of background colors and icons. You have the flexibility to add multiple lines of text, as well as change the size of the text to have both headlines and subsequent content. The panels auto-adjust the width of your Confluence page’s content to keep a consistent look and feel.


Page Comments

We saved this one for the last of the built-in functions for highlighting within Confluence, as it’s really not a technique built for the convenience of the reader, but more so the content creators and editors. That being said, it does highlight text in what most would consider as the original concept of “highlighting text” akin to our school days; however, it comes with some drawbacks. 


If there is a great deal of text to highlight on a page using the commenting feature, it can quickly become cluttered, making it difficult to read. It also looks somewhat unprofessional to use what is really an editing tool for the purpose of a design need, particularly if this will be something individuals outside of your organization will need to access. And a final note, the highlighted text only stays as such if and while the comments are left as unresolved. If and when they are marked as “resolved”, the comment and thus the highlighting is removed.


Third-party Macros Like Aura

So we’ve taken a look at the macro and feature options for highlighting already included with Confluence, now, let’s take a look at a stand-out, third-party app; Aura Content Formatting Macros from appanvil.

Aura isn’t just one macro, it’s a full suite of formatting macros for Confluence cloud. With everything from customizable buttons, cards, panels, status, backgrounds, dividers, and more, you can create highly appealing and engaging page designs to take your Confluence instance to the next level. 

Aura highlight text


Using WYSIWYG (What You See Is What You Get) page creation, either from scratch or from hundreds of templates, it’s simply drag-and-drop to achieve a new level of creativity in Confluence.

And since we’re on the topic of highlighting text, the Aura Panel macro gives you the ability to highlight your content in a format that is both easier-to-read and more attractive. Customize everything from the text header (title, icon, alignment, etc.) to the shape, size, and color of the panel itself.

You can try Aura for free to see just how powerful it is. If you have ten or fewer users on your Confluence instance, it’s free forever under Atlassian’s cloud pricing model. Either way, we think you’ll find Aura’s incredible set of macros not only useful for your highlighting needs, but for all your Confluence formatting efforts.

That’s A Wrap to Highlighting in Confluence

This article explored various ways to highlight text in Confluence. Let’s recap the options and who they’re best suited for:

  • Status Macros: Ideal for marking urgency or status levels. Great for team collaboration and task management.
  • Text Color Change: Simple and quick for basic visual distinction within text blocks.
  • Panel Macro: Offers predefined color-coded sections for different purposes (info, warning, etc.). Suitable for short, informative highlights.
  • Page Comments: While not ideal for reader experience, it allows internal notes and highlights for collaboration.
  • Aura Content Formatting Macros: A comprehensive suite offering customizable panels, backgrounds, and other formatting tools. Ideal for creating visually appealing and engaging content with a wide range of highlighting options.


We hope this has helped give you a wide variety of options to highlighting or calling attention to, content within your pages. Give them all a try, as using all these tools will help make your content stand out from the crowd. Enjoy a new level of creativity in Confluence!



Supercharge your Confluence

Let’s create something extraordinary together

Schedule a free consultation with our team and let’s make things happen!