Content Formatting Macros for Confluence Server and DC


The Highlight macro changes the background colour 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.

    highlight 01
  5. Complete the desired fields.







    Specify the colour to be used.

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

    Accepts hexadecimal values.




    CSS Class

    The class attribute of the element




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

  6. The macro will then appear on the page.

    highlight 02


Standard Use

The key difference between this macro and the Background Colour is that this macro allows for the highlight of just a portion of content.

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

With Colour parameter set to red, yellow, green, cyan, blue and purple respectively.
highlight 03
With Colour parameter set to orange and violet respectively.
highlight 04

Hexadecimal Colour Code

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

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


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 colour using the Confluence provided text formatting toolbar.


Frequently Asked Questions

Q: Can I highlight an entire block of content?

A: Yes. Use the Background Colour.

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

A: Unlike the colour 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 colour names, such as "grey", don’t seem to work in all browsers - why?

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

Q: How do I change the colour of text?

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

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

A: If using a standard theme, there are some limited options to change colours. If using the Builder theme, complete control over all colours 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.