Unknown macro: {float}
Differences in Confluence Hosted

If you are using Confluence Hosted, the plugins and macros are installed for you by Atlassian. Refer to the list in the Confluence Hosted FAQ. Read more about the [feature limitations in Confluence Hosted].

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.

Including a macro in your page

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:

  • to specify the file formats of the attachments displayed.
  • to choose whether or not you want old versions of the attachments displayed.

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}



Confluence Macros

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.

Bookmarks Macro

Includes a list of bookmarks on a Confluence page.

変更履歴マクロ

Displays a history of updates made to a page.

チーズ マクロ

Displays the words "I like cheese!"

子ページ表示マクロ

Displays the children and descendants of the current page.

コー​ド ブロック マクロ

Displays code in your document with the appropriate syntax highlighting.

Color Text Macro

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.

Dynamic Tasklist Macro

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.

Flowchart Macro

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.

HTML マクロ

Renders your specified HTML code within the current page.

IM Presence マクロ

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.

Jira 課題マクロ

Displays a list of JIRA issues in a page.

JIRA Portlet Macro

Displays a JIRA dashboard portlet in Confluence.

JUnit レポート マクロ

Display a summary of JUnit test results.

Layout Macros

Format a page into columns.

Loremipsum マクロ

Display a few paragraphs of pseudo-Latin text.

Navmap Macro

Renders the list of pages associated with a specified label as a navigable map.

書式設定済みマクロ

Displays a block of text in monospace font.

Nolink and nl Macros

Prevents the browser from automatically hyperlinking a URL.

注意マクロ

Displays a block of text in a yellow highlight box.

パネル マクロ

Displays a block of text within a fully customisable panel.

Recently Updated Content Macro

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.

RSS フィード マクロ

Displays the contents of an RSS feed.

Search Macro

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.

Spacegraph Macro

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.

Thumbnail Macro

Creates a thumbnail of an inline image.

Userlister マクロ

Displays a list of Confluence users, from an optional group.

警告マクロ

Displays a block of text in a red highlight box.

Welcome Message macro

Includes the Confluence site welcome message.

Other macros

Other macros are available as [plugins] or as [user macros], and can be installed by your Confluence administrator.

Customers using Adaptavist macros or plugins might be interested in the Adaptavist's Confluence user guide.

Some examples are:

  • {toc} macro, provided by the [Table of Contents Plugin] - full documentation by CustomWare.
  • {float} macro and others, provided by the [Composition plugin] - full documentation by CustomWare.

Writing your own macros

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 2.7 User Guide.