Skip to end of metadata
Go to start of metadata


The Highlight macro changes the background color of a section of content. 

This highlights and promotes a section of content.



Click Insert > Other Macros.


Select the Highlight macro from the provided list.


Complete the desired fields.




Specify the color to be used.

There are several special pastel colors: yellow (default), redbluecyangreen and purple.

Accepts hexadecimal values.




CSS Class
The class attribute of the element.
Output typeSpecifies that the macro will be displayed inline with the surrounding content.single selectInline(error)

The "myColor" default parameter defines the background color for the content contained within the macro, and can be either a common color name (supported by most browsers) or a hexadecimal color code (supported by all browsers).


The macro will then appear on the page.




Standard Use

The key difference between this macro and the Background Color is that this  macro allows you to  highlight just a  portion of content.

There are several built-in pastel colors ideal for use as backgrounds:

With Color parameter set to red, yellow, green, cyan, blue and purple respectively.

Which results in: red  yellow  green  cyan  blue  purple. You can also use many of the standard browser color names, except those shown above, to display additional colors. For example:

With Color parameter set to orange and violet respectively.

Which results in: orange  violet

Hexadecimal Color Code

To make sure a specific color is displayed, use a hexadecimal color code:

With Color parameter set to a hexadecimal value of #003366.

Which results in: Slate blue You'll note that the black text is difficult to read so you may also want to change the text color using the color macro.

Please try to keep a contrast between the text and the background, so that it is still clearly readable. In our example above, the slate blue background made the black text barely readable.


You may also want to change the text color using the Confluence provided text formatting toolbar.


Frequently Asked Questions:


I'm annotating revisions to text - is there a quicker way to mark inserted and deleted text?


Yes. See Text Formatting.


Can I highlight an entire block of content?


Yes. Use the Background Color.


I'm using hexadecimal codes, but they are not working - why?


Unlike the color macro, this macro requires that "#" is included at before the number.


Where can I get HTML text color codes from?


Try HTML Color Picker.


Some color names, such as "grey", don't seem to work in all browsers - why?


Color names are supported differently by different browsers. To be 100% sure of getting the right color, use the hexadecimal color code instead.


How do I change the color of text?


Use the text formatting tools found on the toolbar.


How do I change the default background color of my page, etc?


If using a standard theme, there are some limited options to change colors. If using the Builder theme, complete control over all colors are provided using Custom CSS Styles.


Can I put a graphic in the background?


Yes. The Span Tag and Style Sheet allows for more formatting to content.

See Also:


Top of page

  • No labels