The Message Box macro allows you to add an Atlassian-styled highlighted message box to your page, providing context and relevance to information you want to call out.


  1. Navigate to the page you want to edit.

  2. Click Edit.

  3. Click the position where you want to add a message box. This can be repositioned later, if desired.
  4. Click Insert More Content Other Macros.

  5. Select the Message Box macro from the Macro Browser.

    Macro Browser with the Message Box macro highlighted.
  6. Complete the required parameters to customize the message box.



    Enter the title or header text to display in the body of the message box.




    Message Icon

    Choose a message icon option:

    • None: no icon is displayed in the message box.

    • Default: the default icon for the selected message type is displayed, e.g. a green tick is displayed for a Success message box.

    • Preset icon: select from a list of Content Formatting icons. See the icon reference below.

    single select



    Message Type

    Select the type of message to display:

    • generic

    • warning

    • error

    • success

    • hint

    single select




    Option to specify a unique ID for this element. If using this parameter to apply styling to the element, do not include the # selector.





    Option to apply a custom CSS class to the element. Enter the CSS class name(s) to apply to the macro (case sensitive); multiple classes can be separated by a space or comma. Do not include the . selector in the class name. Classes must be part of your Global Confluence CSS or defined in a CSS Stylesheet macro that you have added to your page.




  7. Click Insert. The macro placeholder displays, with space to add your message box contents.

    The placeholder for a Message Box macro.
  8. Enter the text that you want to display in the message box. It is shown below the title defined in the Title parameter.

  9. Save the page to view the rendered message box. 

    An example saved and rendered Message Box macro.

Style reference

Icon reference

Icons may look slightly different depending on your version of Confluence.

A key to the icons available in Confluence.