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

Decorator Macros are Velocity macros which are used to draw complex or variable parts of the page such as menus and breadcrumbs when editing Custom decorators. Decorator macros can be inserted anywhere in your templates.

The macro is called by inserting a string of the form: #macroName("argument1" "argument2" "argument3").There are no commas between the arguments. Unless otherwise noted, these macros take no arguments.

NOTE: These macros will only work reliably when customising main.vmd. They may not work in other Velocity decorators. Decorator macros will not work inside normal confluence pages.


(warning) The information on this page does not apply to Confluence Cloud.




Draws the "You are here" breadcrumbs list, like the one found above the page name in the default template.


Includes a confluence page with the specified title. If you have 2 or more pages with the same title across multiple spaces, this macro will include the page belonging to the space you are currently viewing.


Inserts a search box into the page, like the one to the far right of the breadcrumbs in the default template.


Draws the global navigation bar, as found in the top right-hand corner of the default template. The navigation bar can be displayed in two modes:


Displays the navigation bar in its default mode: drawn as a table of links with coloured backgrounds and mouse-over effects.


Displays the navigation bar as series of text links separated by




Draws the user-specific navigation-bar. This bar contains the links to the user's profile and history, or to the login and signup pages if the user is not logged in.


Draws the help icon, and link to the Confluence help page.


On pages where a printable version is available, draws the printable page icon, linking to the printable version of the page. Otherwise, draws nothing


When you are viewing a page in a Confluence space, draws the name of the space that page is in. Otherwise, writes the word "CONFLUENCE".The "class" argument is the CSS class that the title should be drawn in. Unless you have customised your Confluence installation's CSS file, you should call this with "spacenametitle" as the class: #pagetitle("spacenametitle")


Writes out the "Powered by Confluence" and Confluence version-number boilerplate found at the bottom of the default template.


Draws the fading shadow-effect found at the bottom of the content area in the default template.


Inserts a link to the dashboard page.



  1. FYI - In addition to the above decorator macros you can also use $helper.renderConfluenceMacro in your layouts to render normal Confluence macros, for example:

    Thanks to Ruchi Tandon[Atlassian] for this when commenting on my help ticket at !

  2. Anonymous

    I cannot find the definition for the macro #usernavbar() in the file ...\confluence-4.1.3-std\confluence\template\includes\macros.vm. In Confluence 3.5.X it was there, but in the Version 4.1.3 I can't find it. Where is the macro definition:




  3. Anonymous

    Does #printableicon() still exist in 4.x? It does not seem to work and is not to be found in macros.vm.

  4. Anonymous

    Hello we like to add Wikisame and Confluencesame to the new StandardDesign (= integrated design)

    We tried the following syntax:

    $helper.renderConfluenceMacro("{ConfluenceSame:title=Related content|spaceKey=[SpaceKey]|maxLimit=7|width=400}")

    (nothing happens)





    $helper.renderConfluenceMacro("{WikipediaSame:title=More on Wikipedia|maxLimit=10}")

    (we get a nullpointer exception)




    Does somebody know how and where to implement?

  5. Anonymous

    additional information:

    WikiSame + ConfluenceSame should be added to the bottom of the left sidebar / navigation-bar

    Feedback would be very nice!