Documentation for Confluence 5.7.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

The Note macro displays a block of text in a yellow highlighted box. This is useful for emphasising important information.


My note

This is the content of my note.

Using the Note Macro

To add the Note macro to a page:

  1. In the Confluence editor, choose Insert > Other Macros.
  2. Find and select the required macro.

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

To edit an existing macro: Click the macro placeholder and choose Edit. A macro dialog window will open, where you can edit the parameters of the macro.

Add the text of the note to the body of the macro placeholder.


Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).




Optional Title


If specified, the title is displayed in bold next to the icon.

Show Exclamation Mark Icon


    • true – displays the warning icon
    • false – the icon is not displayed

Code examples

The following examples are provided for advanced users who want to inspect or edit the underlying markup for a Confluence page. 

Macro name: note

Macro body: Accepts rich text.

Storage format example

Wiki markup example



  • No labels


  1. Anonymous

    this is orders of magnitude more complicated than wiki markup.  What are you thinking atlassian?

    1. Hallo there anonymous

      If you like, you can give your feedback on the following page, where our product managers are collating and responding to feedback: Confluence 4.0 Editor - Customer Feedback

      Cheers, Sarah

    2. Hi Anonymous – you can still insert note macros into pages using wiki markup (version 4.1.2+) with Autoformatting. See this post for details and a demo.

  2. Anonymous

    How do I copy a note? Or any of the other macros, such as Info or Tip. This was a snap with wiki markup. I am having to readd the Note macro, then copy-paste first the header text, then the body text. Is there a better way that I'm missing? This is soooo much slower.

    1. To copy and paste any macro just select the macro by clicking on it – you'll see the macro property panel appear – and copy it to your clipboard before pasting it onto another part of the page or even another page.