The Highlight macro changes the background color of a section of content. This allows for highlighting or promoting a particular portion of content on a page.


  1. Go to the form you wish to edit.

  2. Click Edit.

  3. Click Insert More Content, and select Other Macros.

  4. Select the Highlight macro from the provided list.

    The Macro Browser with the Highlight macro available.
  5. Complete the desired fields.







    Specify the color to be used.

    There are several special pastel colors: yellow (default), red, blue, cyan, green and purple.

    Accepts hexadecimal values.



    CSS Class

    The class attribute of the element



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

  6. 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 for the highlight of 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.
Text showing standard colors available with the Highlight macro.
With Color parameter set to orange and violet respectively.

An example of the Highlight macro coloring text orange and 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.
Example text with a black highlight.

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.

The text color options available in Confluence text formatting toolbar.

Frequently Asked Questions

Q: Can I highlight an entire block of content?

A: Yes. Use the Background Color.

Q: I’m using hexadecimal codes, but they are not working - why?

A: Unlike the Color macro, this macro requires that "#" is included at before the number.

Q: Where can I get HTML text color codes from?

A: Try HTML Color Picker.

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

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

Q: How do I change the color of text?

A: Use the text formatting tools found on the toolbar.

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

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

Q: Can I put a graphic in the background?

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