The Alert macro allows you to create a pop-up message that is displayed when visitors first come to your page. With this, you can alert viewers about the content of the page or highlight important information. There are a number of standard options for quick and easy implementation, or you can create your own custom version with your choice of content, image, and layout. You can also choose to make the alert appear every time a user navigates to the page, or it can be permanently dismissed so they only have to view the message once. 

Add an Alert to your page

  1. Navigate to the page you want to edit.

  2. Click the Edit icon.

  3. Click Insert > View More.

  4. Select the Alert macro in the Browse screen.

  5. Customize your alert. Changes you make will be shown in the dynamic preview of the editor.

  6. Click Save. A macro placeholder is displayed.

  7. Click Publish to see the Alert macro in action.

    You can add more than one alert macro to a page. They will appear one after the other when a user views the page, however the order in which they appear will be random.

Change the style of your Alert

There are two different styles of alert you can choose from.

  • Image Alert (the default option)
  • Simple Alert

Below are the default versions of each type of alert in each of the styles. You can further customize any of these Alerts to suit your needs.

Image Alerts

Simple Alerts

Customize your Alert

Add an Image

There are two ways to add an image to your alerts. Both can be found by selecting the Add Image button.

a) Stock image. This option allows you to search for an image from our free image library. Simply select an image and check the preview to see how it looks on your card. When you are happy with the image, select the back button.

a) Upload. This option allows you to add your own image. You can drag and drop an image file into the macro window or click Upload image to select an image file from your local file storage.

Accepted image formats: JPEG, PNG, GIF, ICO BMP, and WEBP 

Maximum file size: 15 MB

Change or remove an image

To chage an image select the pencil icon next to the image name. Then add an image as before.

To remove the image select the trash can icon.

Add option to dismiss your Alert

 If you want to let users choose to only see an alert once you can use the Permanently dismiss option. When the option is checked a Dismiss button is added to the alert give users two options. 

Change the color scheme of your Alert 

Using the color palettes you can change the background and text color of your alert. You can use one of the options from the color palettes or select your own color. You access this by clicking on the paint bucket icon. This will open a color picker nearby. 

Change the color palette

Changing the color palette will change the presented options for Background Color and Text Color.

The options are:-
Default - The options are a standard selection of colors that do not change. There are different options for the background and text colors.

Recently used - The options offered will be the last seven colors you have used in any of our macros.

If you have not yet saved a macro, there will be no color options in the recently used palette.

Local Space  - The options offered in this palette are specific to the space. The Space Admin can create and edit this palette. This may be used for your team's colors of choice.

Organization - The options offered in this palette are the same in every space. Confluence Admins can create and edit this palette. This may be used for your organization's brand colors.

Edit an Alert

To make changes to an alert after it is published, first display the page in Edit mode.

  1. Click the card, then click the Edit icon.
  2. Make your desired changes, then click Save. If you want to edit an alert image, you will need to upload it again.

Remove an Alert Macro

To remove an alert after it is published, first display the page in Edit mode, Then click the alert, then click the Trash icon.


Due to Atlassian limitations, there are a couple of things that do not behave as you might expect:

  • Copy paste: copying and pasting Alert macros that contain image attachments results in the same image ID being assigned to all copies. 
  • Google Chrome Incognito mode: Alert image attachments do not show if Confluence is opened in a Chrome Incognito tab.

Video Walkthrough

Watch our video walkthrough to see the Alert macro in action.

Related Macros

On this page