The Alert macro enables you to create customizable alerts that display when a page loads. Alerts layer above your content on a Confluence page. They can be dismissed by users and will reload each time the page is refreshed.

Example use cases include adding a warning to users that the page that they are viewing is not finalised, that there are specific restrictions for that page, or that there is something of importance on that page.

Any alerts added to a page are visible to all users that have permission to view the page.

Instructions

  1. Navigate to the page you want to edit.

  2. Click Edit.

  3. Click Insert More Content Other Macros.

  4. Select the Alert macro from the Macro Browser.

    The Macro Browser, with the Alert macro shown.
  5. Set up the alert using the following parameters:

    ParameterDescriptionTypeDefaultRequired

    Alert Type

    Select the type of alert to display: Info (blue-default), Success (green), Warning (yellow), Error (red)

    enum

    Info

    (tick)

    Alert Title

    Enter an optional title to display as a message header, e.g. Mission Complete!

    string

    none

    (error)

  6. Click Insert. The macro placeholder displays.
     
    The placeholder for the Alert macro.
  7. Enter any additional information to display to users in the macro body.
  8. Save your page to render the macro. A page can contain multiple alerts.

The Edit screen for the Alert macro. The example configuration is for a success message.

Examples

Success Alert

A rendered example of a Success Alert.

Info Alert

A rendered example of an Info Alert.

Warning Alert

A rendered example of a Warning Alert.

Error Alert

A rendered example of an Error Alert.