Macros
Macros are extensions that allow you to add extra features to your content...
What are Macros?
Macros allow you to apply extra formatting, functionality and customisation to your content. As you'll see from the Related Tutorials sub-section below, there are lots of macros to choose from!
Related Tutorials
We're about one third of the way through fully documenting all the macros - here's what we've documented so far...
Advanced macros enable you to add custom HTML and scripting to your content...
- add-label macro — The {add-label} macro allows you to add one or more labels to a page automatically.
- alias macro — The {alias} macro allows you to create aliases (or shortcuts) for pages...
- create-page macro — The {create-page} macro asks the user for the name of the page and then creates it based on a template...
- div macro — The {div} macro wraps content in a div tag with optional class and styles...
- html macro — The {html} macro allows you to add raw HTML to your pages, but should be used with care...
- html-tag macro — The {html-tag} macro provides a safe mechanism for the addition of specific HTML tags and attributes to be inserted in to your content...
- redirect macro — The {redirect} macro will automatically redirect the browser to an alternate web page either within your own site or on an external site...
- span macro — The {span} macro wraps content in a span tag with optional class and styles...
- style macro — The {style} macro allows you to add custom style sheets to a page or import from an external URL...
Basic Formatting macros allow you to change text colour, put content in panels and other basic formatting requirements...
- align macro — The {align} macro allows you to quickly and easily set the alignment of content...
- bgcolor macro — The {bgcolor} macro allows you to change background colour of a block of content...
- center macro — The {center} macro allows you to quickly and easily center content...
- code macro — The {code} macro is used to display syntax highlited source code...
- color macro — The {color} macro allows you to change text colour quickly and easily...
- copyright macro — The {copyright} macro makes it easy to add customisable copyright marks to your content...
- highlight macro — The {highlight} macro allows you to change background colour of a section of content...
- loremipsum macro — The {loremipsum} macro adds latin text to your page, useful for testing purposes...
- noformat macro — The {noformat} macro is used to display unformatted text on your pages...
- quote macro — The {quote} macro is used to group blocks of content quickly and easily...
- reg-tm macro — The {reg-tm} macro makes it easy to add customisable registered trademarks to your content...
- sm macro — The {sm} macro makes it easy to add customisable service marks to your content...
- strike macro — The {strike} macro provides a highly graphical way to indicate deleted text...
- tm macro — The {tm} macro makes it easy to add customisable trademarks to your content...
Add brain-taxing games to Confluence... 
These Generic macros haven't yet been classified in to a specific category, but you'll find some amazing things here...
- chart macro — The {chart} macro creates pie, line and bar charts quickly and easily...
- display-footnotes macro — The {display-footnotes} macro is used to display any as-yet undisplayed footnotes created with the {footnotes} macro...
- dynamictasklist macro
- excerpt macro — The {excerpt} macro defines a block of text as being the excerpt (or summary) for a page...
- excerpt-include macro — The {excerpt-include} macro displays the an excerpt from another locaiton in your content...
- footnote macro — The {footnote} and {display-footnotes} macros allow you to easily create footnotes in your content...
- form-mail macro — The {form-mail} macro adds a simple, no-frills email form you to your content...
- gallery macro — The {gallery} macro allows you to display a thumbnail image gallery on a page...
- privacy-mark macro — The {privacy-mark} macro highlights parts of your content that are referred to by your privacy policy...
- privacy-policy macro — The {privacy-policy} macro displays a short privacy statement on your site which links to your main Privacy Policy...
- rate macro — The {rate} macro allows visitors to rate various aspects of your content and even themselves...
- rate-table macro — The {rate-table} macro is used to show statistics gathered from the rate macro...
- rollover macro — The {rollover} macro allows you to quickly and easily create CSS rollover effects
Layout macros are used to arrange content in to panels, columns and block quotes...
- card macro — The {card} macro, when used with the {deck} macro, creates a tabbed panel which is ideal for separating out blocks of related content.
- cloak macro — The {cloak} macro is used in conjunction with the toggle-cloak macro to show and hide blocks of content...
- column macro — The {column} macro, when contained within the section macro, arranges content in to columns...
- composition-setup macro — The {composition-setup} macro is used in conjunction with the other composition macros and sets up data that they will need to function correctly...
- deck macro — The {deck} macro, when used with the {card} macro creates a tabbed panel which is ideal for separating out blocks of related content.
- float macro — The {float} macro allows you to position a block of content on the left or right of the page...
- info macro — The {info} macro allows you to quickly and easily highlight useful information...
- lozenge macro — The {lozenge} macro creates a lozenge button with optional link...
- note macro — The {note} macro allows you to quickly and easily highlight important information or warning messages...
- panel macro — The {panel} macro creates a customisable panel that allows you to add a title, border and background colour to blocks of content...
- roundrect macro — The {roundrect} macro allows you to quickly and easily create rounded rectangles
- section macro — The {section} macro, when used in conjunction with the column macro, allows you to create multi-column layouts...
- table macro — The {table} macro and it's related macros allow you to create custom table layouts in Confluence content...
- tip macro — The {tip} macro allows you to quickly and easily highlight hints and tips...
- toggle-cloak macro — The {toggle-cloak} macro is used in conjunction with the cloak macro to show and hide blocks of content...
- warning macro — The {warning} macro allows you to quickly and easily highlight warnings or critical messages...
Navigation and List macros provide additional navigation elements and lists of content, etc...
- anchor macro — The {anchor} macro allows you to create an anchor (or "bookmark") within a page allowing links to jump directly to that part of the page...
- children macro — The {children} macro displays lists of child pages attached to the current page or orphan pages that are not attached to any page...
- clickable macro — The {clickable} macro allows you to quickly and easily link entire blocks of content...
- incoming-links macro — The {incoming-links} macro displays a customisable list of incoming links for the current page...
- link-to macro — The {link-to} macro allows you to link to almost every feature in Confluence...
- noparent macro — The {noparent} macro lists all [USERGUIDE:Orphan Pages] within a space, i.e. pages without a parent...
- page-info macro — The {page-info} macro allows you to display several useful pieces of information about the page in a simple format
- pagetree macro — The {pagetree} macro, is used for displaying a tree view of the page hierarchy.
- scrollbar macro — The {scrollbar} macro displays a linear navigation bar that makes scrolling through adjacent pages easy...
- search-box macro — The {search-box} macro displays a search box on your page...
- spaces macro — The {spaces} macro displays a list of spaces, similar to that on the dashboard...
- toc macro — The {toc} macro displays a table of contents based on headings present on the page...
- toc-zone macro — The {toc-zone} macro displays a table of contents based on headings contained within it...
- version-history macro — The {version-history} macro allows you to display a table detailing the changes that have been made to the page...
User and Security macros display users lists and also allow content to be filtered depending on the logged in user...
- aim macro — The {aim} macro shows the online status for a specific AOL Intant Messenger user...
- hide-from macro — The {hide-from} macro hides page content from specific users or groups...
- icq macro — The {icq} macro shows the online status for a specific ICQ user...
- icq-time macro — The {icq-time} macro displays an ICQ local time panel for a specific ICQ user...
- show-to macro — The {show-to} macro displays content only to specific users or groups...
- space-access macro — The {space-access} macro lists all registered users who can access a space (eg. your website or intranet)...
- yahoo macro — The {yahoo} macro shows the online status for a specific Yahoo Instant Messenger user...
Frequently Asked Questions
| Q |
Are there any macros that aren't listed here? |
| A |
Probably. New macros are being written all the time so check the Confluence Extensions page to see the latest developments. |
| Q |
Can I make my own macros? |
| A |
Yes. You can either create simple [USERGUIDE:User Macros] or your own custom [USERGUIDE:Plugins]. |
| Q |
I want a custom macro writing, will Adaptavist do it for me? |
| A |
Yes. Adaptavist have already written numerous user macros and plugins. For more information, please Contact Us. |
See Also
Added by
This should be quite useful--I'm glad I stumbled across this site!
alignment is misspelled as alignement under the align macro
.
-Ben H.
Is it possible to name areas on a page such that they can be referred to and be included and be automatically updated in other pages when the named area is edited?
This would presumably be similar to the 'excerpt' and 'include-excerpt' macros, however I would like to have an 'excerpt' and a number of named areas on the same page.
TIA.
Chris.