Documentation for Confluence 2.5.4 - 2.5.8.
Documentation for [Confluence Cloud] and the latest Confluence Server is available too. 
Macros perform programmatic functions within a page and can be used to generate complex content structures or dynamic content.
Macros allow you to create markup or include dynamic content in a page that may not be possible using Confluence notation. For example, the Attachments macro will list a page's attachments in the page itself, so that readers do not have to visit the Attachments tab.
Generally speaking, a macro is simply a command wrapped inside curly braces {...}.
For instance, the Attachments Macro is written as:
{attachments}
Optional Parameters in Macros
For each macro, you can also have optional parameters that can often be combined to refine or control the macro's output.
With the Attachments Macro, for instance, you have two optional parameters:
These optional parameters are included within the curly braces, following a colon, like this:
{attachments:patterns=.*jpg}
When specifying more than one parameter within the same macro, the pipe symbol ('|') is used to separate one from the other, like this:
{attachments:old=true|patterns=.*jpg}
Many macros are shipped with Confluence. The macros currently available in Confluence are listed below. For each macro, all the optional parameters are also listed with examples of their usage.
Displays a list of attachments belonging to the current page. |
|
Lists the most recent news items in the space. |
|
Displays the children and descendants of the current page. |
|
Displays code in your document with the appropriate syntax highlighting. |
|
Changes the colour of a block of text. |
|
Used with the Section Macro. Defines columns within the page. |
|
Renders a list of content associated with specific labels |
|
Renders a create space button linked to the create space page. |
|
Displays a dynamic task list which can be modified in 'view' mode. |
|
Allows you to define a part of the page as the page's 'excerpt' which is then used by other macros to summarise a page's content. |
|
Allows you to display an excerpt from another page within the current page. |
|
Displays a list of your favourite pages. |
|
Includes one page's excerpt in another. |
|
Displays flowcharts and other diagrams composed of shapes joined by lines. |
|
Forms a thumbnail gallery of all images attached to a page. |
|
Renders a list of links to global reports within a table. |
|
Renders your specified HTML code within the current page. |
|
Displays graphically when a contact is online. |
|
Inserts the contents of the specified page into the current one. |
|
Displays a block of text in a blue highlight box. |
|
Displays a list of JIRA issues in a page. |
|
Displays a JIRA dashboard portlet in Confluence. |
|
Display a summary of JUnit test results. |
|
Format a page into columns. |
|
Renders the list of pages associated with a specified label as a navigable map. |
|
Displays a block of text in monospace font. |
|
Displays a block of text in a yellow highlight box. |
|
Displays a block of text within a fully customisable panel. |
|
Includes a list of recently changed content. |
|
Lists labels most recently used in a specified scope (Global, Space, or Personal) |
|
Lists labels frequently appearing on the same pages as the current page's labels. |
|
Displays the contents of an RSS feed. |
|
Searches Confluence, and includes the results in the page. |
|
Used with the Column Macro to define columns within the page. |
|
Includes the summary of a Confluence space in the page. |
|
Displays a chart of the pages in a space and their connections. |
|
Displays a list of all spaces visible to the user. |
|
Displays a block of text in a green highlight box. |
|
Creates a thumbnail of an inline image. |
|
Displays a list of Confluence users, from an optional group. |
|
Displays a block of text in a red highlight box. |
|
Includes the Confluence site welcome message. |
Other macros are available as plugins or as user macros, and can be installed by your Confluence administrator.
To learn how to write your own macro, or use macros written by other people, read the Confluence Plugin Guide
Confluence Notation Guide Overview
Confluence Plugin Guide
Plugin Index
User Macros
Take me back to Confluence User Guide
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.