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

Using macros helps you to expand the capabilities of your Confluence pages, allowing you to add extra functionality or include dynamic content. For example, use the Attachments macro to list files attached to a page, or use the Widget Connector macro to include things like a YouTube video or Twitter feed.

Adding a Macro to your Page

Including Macros with the Macro Browser

On this page:

To add a 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.

Macro Parameters

Many macros have optional parameters you can use to control the macro's output.

With the Attachments Macro, for instance, you have two optional parameters allowing you to:

  • Specify the file formats of the attachments displayed.
  • Choose whether or not you want old versions of the attachments displayed.

Macro Placeholders

Macro placeholders are displayed in the editor where you have added a macro to the page.

When editing a page, you can:

  • Double-click a macro placeholder (or click the placeholder and choose Edit) to open the macro dialog window, where you can edit the macro's parameters.
  • Select a macro placeholder to cut, copy and paste the macro.

Confluence macros

Below is a list of the macros currently bundled with Confluence. Click a macro name for details of the usage, including optional parameters and examples.

Creating your own macros

Users with System Administrator permissions can create user macros - see Writing User Macros

If you want to create something more complex, you can develop your own plugin - see Writing Confluence Plugins.

Getting more macros from The Marketplace

You can find a wide range of Atlassian and third party macros at The Marketplace. These are distributed as add-ons and can be installed by a Confluence Administrator.

Page: Task Report Macro Page: Roadmap Planner Macro Page: Activity Stream Macro Page: Anchor Macro Page: Attachments Macro Page: Blog Posts Macro Page: Change-History Macro Page: Chart Macro Page: Cheese Macro Page: Children Display Macro Page: Code Block Macro Page: Column Macro Page: Content by Label Macro Page: Content by User Macro Page: Content Report Table Macro Page: Contributors Macro Page: Contributors Summary Macro Page: Create from Template Macro Page: Create Space Button Macro Page: Excerpt Include Macro Page: Excerpt Macro Page: Expand Macro Page: Favourite Pages Macro Page: Gadget Macro Page: Gallery Macro Page: Global Reports Macro Page: HTML Include Macro Page: HTML Macro Page: IM Presence Macro Page: Include Page Macro Page: Info Macro Page: JIRA Chart Macro Page: JIRA Issues Macro Page: JUnit Report Macro Page: Labels List Macro Page: Livesearch Macro Page: Loremipsum Macro Page: Multimedia Macro Page: Navigation Map Macro Page: Network Macro Page: Noformat Macro Page: Note Macro Page: Office Excel Macro Page: Office PowerPoint Macro Page: Office Word Macro Page: Page Index Macro Page: Page Properties Macro Page: Page Properties Report Macro Page: Page Tree Macro Page: Page Tree Search Macro Page: Panel Macro Page: PDF Macro Page: Popular Labels Macro Page: Profile Picture Macro Page: Recently Updated Dashboard Macro Page: Recently Updated Macro Page: Recently Used Labels Macro Page: Related Labels Macro Page: RSS Feed Macro Page: Search Results Macro Page: Section Macro Page: Space Attachments Macro Page: Space Details Macro Page: Space Jump Macro Page: Spaces List Macro Page: Status Macro Page: Table of Contents Macro Page: Table of Content Zone Macro Page: Tip Macro Page: User List Macro Page: User Profile Macro Page: User Status List Macro Page: View File Macro Page: Warning Macro Page: Widget Connector Macro


  1. Is there a macro to increase the font size? I know there is one to decrease the size {smalltext}, but I am getting several requests in make the fonts larger.

    1. There's no built-in macro to do this, but you could easily do it with a User Macro. Create a macro called 'big', which converts its body to HTML and outputs HTML, with the following contents:

      You can then use {big}Important{big} to create big text. Nesting macros isn't currently supported, so to make it extra-big, you'd need to add more macros, or make the font-size a parameter:

      You could use this macro like this: {big:250%}Really important!{big}.

      We also have an outstanding feature request to add font-size to the wiki markup which you can vote for: CONF-5309.

  2. Is there a macro that allows you to collapse a table?

    1. Anonymous

      I use the [expand|] macro a lot to hide all sorts of stuff, tables included, if thats your intention.

  3. Notation Guide in Confluence makes mention of {table-data] macro but nothing to be found here or in Working with Tables.

    Trying to find out if it possible to call tables created using

    Unknown macro: {table-data}

    macro onto other pages within same space? At same time I am keen to display only certain columns of the table data and not allow editing.

    1. Hi Tom,

      The {table-data} macro is provided by the third-party Scaffolding Plugin. You can learn more about the plugin and the macro from these pages:

      Hope that helps,

  4. Anonymous

    I need to use strings like

    Unknown macro: {somethinginhere}

    in my wiki page. I keep getting the error 'Unknown Macro'. How to let wiki ignore these curly braces?. Any help is appreciated.



    1. You can add a backslash before the curly braces.



      1. Anonymous

        Great - just the answer I was looking for. Thanks

      2. Anonymous

        I have 200 places in my text with {}.  Is there some way I can tell confluence to ignore them all without having to put a '\' in front of each one?

  5. Anonymous

    Thanks to tell me in which language are the macros written or where I can find a user manual of this language (instructions beginning with #)

    1. Hi

      Thanks to tell me in which language are the macros written or where I can find a user manual of this language (instructions beginning with #)

      I believe the language is called Velocity. To learn more on Velocity language please refer to this documentation:

      Hope that helps.
      Best rgds,

  6. Anonymous

    Is there a "hit counter" macro available?  We'd like to see how many people are viewing our wiki pages.

    1. Hi

      I think you can try the Confluence Usage Stats. To learned more on this plugin please refer to the following link:

      Also, the Confluence Usage Stats is ship together with the latest Confluence version. You might need to enable it via Confluence admin >> Plugins

      Hope that helps.
      Best rgds,

  7. Anonymous


    I need a macro to show content from an other page for a certain time or a certain calendar date. I know the macro and I need that with a time or date limiting. If the time is over or the date is reached, the content have to be hidden.

    Thanks for your help.


    Ulrike Trippel

    T-Systems Germany

  8. Anonymous


    I need a macro to show content from an other page for a certain time or a certain calendar date. I know the macro "excerpt-include:Home|nopanel=true" and I need that with a time or date limiting. If the time is over or the date is reached, the content have to be hidden.

    Thanks for your help.


    Ulrike Trippel

    T-Systems Germany

  9. Hi,

    Can you document how to localize a macro providing an English, French, German... description (and potentially the same for the arguments...) or a good example with all the source code for one?

    So far our macros are described in the atlassian-plugin.xml used for our theme like below. Can we keep this way to do it or do we need to do it differently, implement an interface in the macro or any other solution? I have trie to add a section <description lang="fr"> or <description lang="fr_FR"> with no success
    <macro name="english" key="english" >
                This very simple macro displays its content if the current language is English (or is not French).
                The french macro does the opposite.

  10. Anonymous

    Is there a way to populate the list of people who have RSVP'd into a table. The idea is we want to use RSVP t so people who want to request an item can just submit there name using the RSVP macro but we want this data to be automaticaly placed into a table so we can track it as well. Also is there a way to have the total amount of items be listed and it automaticaly decrease as people RSVP? I know I could just use MS access to build sometihng like this but we want the community to be able to do this. 

  11. Is it possible to restrict a Macro of a plugin from the users with out listing it in the macro browsers? this is very much like the restrict option which is available in hiding the user-macros to the users.

  12. Hello. How do you add a macro similar to the one on the top of this page that links to previous version of Confluence? The requirement would be similar to what's displayed on this page: 1. Has to be placed above the page title and 2. appear on all subpages within the space. I am new to macros so a detailed instructions would be most appreciated. Thank you!

    1. Hallo jason

      We're using the Documentation theme in this space. The theme allows you to add content to the page header and footer, and the left-hand navigation bar too.

      The header, footer and navigation bar accept wiki markup. To get the specific header that's at the top of this page, we have the following markup:

      There's more about the Documentation theme here: Configuring the Documentation Theme.

      Cheers, Sarah

  13. Anonymous

    Please can we have the 3.5 User's Guide back? It contained so much more useful information. For example:

    • This page (Working with Macros) was in a sensible place. Now I find it under "Customising Confluence"??
    • The Index was not just a bunch of labels. Who knows what labels you've used?
    • Macro parameters were given in detail, with examples of syntax.

    Your tech writers are trying to be too clever by half. I speak as a tech writer...

    1. Hallo anonymous

      I'm sorry that you've been having trouble finding the information that you need. I agree with you that this page (Working with Macros) was in an odd place. I've moved it under the section called "Creating Content". The technical writers spent a fair bit of time rearranging the table of contents in time for the Confluence 4.1 release, in the hope that it would be simpler to follow. So feedback like this is useful.

      I think the index in the 3.5 guide was the same. It's possible the Confluence user interface that is making it look different, and more like a bunch of labels. In previous versions, the labels were displayed as simple links, whereas now each label is a big block. But the functionality of the index is unchanged. The Confluence 3.5 User's Guide is still around: Working with macros. However, it's hosted on this wiki, which is of course using the latest version of Confluence.

      I think that the reason for removing the details of the macro syntax was that Confluence no longer uses wiki markup as its primary entry format, although you can still insert it on initial input. The macro browser UI gives the details of the parameters. I do agree, though, that in some cases the simplification went too far, especially given the fact that wiki markup is still a valid way of entering content. I hope to fix this, as soon as time allows. At the moment, my focus is on documenting the upcoming release. (smile)

      Cheers, Sarah

      1. Task logged: CONF-24972 - Document the markup for macro names and parameters - both wiki markup and the new storage format Resolved

      2. Hi Sarah

        Now that I've found my login ID and password I can identify myself! Thanks for your prompt reply, and your openness to change things. Your flexibility is appreciated!

  14. Is there any way as the administrator of the wiki to customize the default widgets at the bottom of the Insert menu? Our employees don't find many of these options useful, whereas we heavily rely on Sections and Columns and a number of other widgets that are harder to find.

    1. Searching for the same possibility - and this post (even if it is older than 2 years now) was the only thing I could find regarding this topic.

      So: How can one customise the position entries of the macros listed inside the editor's macro dropdown list to throw out some my users don't need and insert more frequently used ones?

      1. Hi Martin, there's a feature suggestion about this issue here.  Feel free to comment or vote on the issue.  

        CONF-28832 - The insert menu in the editor should show the items I use most Open

  15. Anonymous


    Hi, can somebody help me? (smile) i need insert macro like page tree, but not only title of page... i need in one row display another informations from DIV boxes... any idea? Thanks

  16. Anonymous

    I don't seem to have the View File macro available to me. I'm an administrator, how do I enable it? Thanks!

  17. Anonymous


    Please help me to use forum macro in my page to make a forum for my group.



  18. Anonymous

    Is there any way to add macros to the header and footer of a page? Someway to place it into the pdf export stylesheet so I can have dynamic content?

  19. Anonymous

    excuse me, i cant figure how the hack to edit an existing a macro. most unintuitive ui

  20. Hello,

    The "Documentation Link macro" was documented in Documentation Link Macro (3.5) using http protocol.

    In the latest documentation this macro is not found. Is this macro depreciated?

    Will this macro support https in the near future?

  21. Is there any way we can edit the JIRA ISSUE macro to add more columns .

    Currently there is no way to display the estimates from JIRA , its coming as Blank Column .

    Can we edit the JIRA ISSUE macro code .

    If yes can any body point me  to the right direction .


  22. Any macro to count words on a page?  Our translation team uses this information to get pricing from vendors.

  23. Hello,

    We are looking for a Macro that will shade the space in a table (individual cells) .  We have the basic blue, green, red, yellow and have played around with the 'inspect element' colours (Which works well while in 'edit' but is lost as soon as the page is saved.  Is there a macro we can download so that we can customise the colours?

    Thank you

  24. Hi All,

    I am using confluence 5.2.5, When i use curly braces ({), I couldn't get the list of Macros, I have checked whether Macros have been disabled under user profile -> Setting, but it's not.

    Can you please help me on this.. How can i achieve this.

    1. Hi Akash, Check that you do not have autocomplete and autoformat disabled   Profile > Settings > Editor.  If these are both enabled (unchecked) then I would suggest contacting support as it sounds like Confluence is having trouble initialising the macro browser. 

  25. Is there a macro that enables me to 'copy to clipboard' where a user can click a 'button' and the macro copies only a selected range of text to the clipboard? Our team would be moving our Knowledge-base to Confluence and our older wiki (DokuWiki) has this feature. I want to have the same feature replicated within Confluence. Please suggest.

    1. Hi Bosco,

      There's no macro to enable copying to the clipboard, but I did find a similar issue that was raised for copying code blocks.

      CONF-34168 - Add button to copy Code Macro content to clipboard New

      You can watch and comment on that issue, or raise your own if you think it's too different.

    2. HI Bosco,

      The Code Block macro may help you; if you choose Syntax highlighting with Plain Text, the content can easy be copied to the clipboard by dubble-click the content followed by <ctrl>C.

      Hope this helps you.