Message Box

The Message Box macro allows you to add an Atlassian-styled highlighted message box to your page. You can easily use the standard options, but if you wish to customize the background color and text, you can combine the Message Box macro with our CSS Style Sheet Macro.

Message boxs can be very useful!

You can use them to provide context and highlight the 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.
  6. Complete the required parameters to customize the message box.


    Message Type

    Select the type of message to display:

    • generic

    • warning

    • error

    • success

    • hint




    Message Box Title 

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

    single select




    Choose a message icon option:

    • None: no extra 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




    Specify a unique ID for this element. Use this to link to Tooltip, Dialog, or Rollover Macros. 

    If using this parameter to apply styling to the element, do not include the # selector.




    CSS Class

    Use in combination with Global Confluence CSS or a CSS Stylesheet macro that you have added to your page.

    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.




  7. Click Insert. The macro placeholder displays, with space to add your message box contents. 
  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. 

    Published Result

    Example Message Title

    Example text inside the message box

Style Reference

Generic Message Box

Generic Message Box with default icon

Warning Message Box

Warning Message Box with default icon

Error Message Box

Error  Message Box with default icon

Success Message Box

Success  Message Box with default icon

Hint Message Box

Hint  Message Box with default icon

Icon reference

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

If you are still stuck please contact our support team who can offer you more assistance. 
You can try our full range of content formatting macros for free by visiting the Marketplace.
On this page