Macros

Macros allow you to perform programmatic functions within a page, and can be used for generating more complex content structures.

Show Plugins By Category

Building your own?
Take a look at the Atlassian Developer Network for pointer to all the resources you'll need for developing your own plugins. For more detail on how to build your own custom macros, see the guide here.
System macros
Confluence includes a large number of macros out of the box, see the guide to Confluence macros.
Want to see your favourite bug fixed?
Vote for the less popular features requests: Macro Component Issues Sorted by User Votes

Categories

Please help to keep these organized

Plugin Categories
  • Action Macros — perform, launch, start, or execute a specific action from a display page
  • Communication Macros
  • Content Macros — generate content for display
  • External Content — Macros and Plugins to include, wrap, embed, or otherwise expose external content within a confluence page, either from an attachment or an external url
  • Formatting Macros — Format or re-format content, manipulate style, reorganize display, but do not generate content de-novo
  • Games
  • Image and Visualisation — generate image content, either inline, attached or using 3rd party libraries or services
  • Other
  • Prototype Macros — placeholder or proof-of-concept macros which may be incomplete, buggy, dangerous, or otherwise unsupported
  • Scaffolding Plugin — This plug-in contains macros for creating 'permanent templates' and editable forms.
  • User Feedback — Macros and plugins used to solicit user feedback

By Category

Plugins
  • Action Macros — perform, launch, start, or execute a specific action from a display page
    • Create Page Macro — The {create-page} macro asks the user for the name of the page and then creates it based on a template.
    • Dynamic Table Macro — This macro creates and maintains a table that is modified dynamically in the view mode, similarly to the Dynamic Task List. Additionally it allows reordering of the rows.
    • Confluence Dynamic Tasklist 2 — A wiki-based checklist for tasks with easy, ajax-driven task completion.
    • Run Plugin — Dynamic content based on substitution of parameters provided by page user.
    • Confluence Livesearch Macro — This plugin makes it possible to search for Confluence content, from Confluence content.
  • Communication Macros
  • Content Macros — generate content for display
    • Dojo Resources — This plugin is required by all others Dojo based Confluence plugins.
    • Dojo Tab Container — Helps you organize content of your page into AJAX tabs.
    • Flexi Blog Posts Plugin
    • JQForms — This plugin provides a collection of plugins that make use of JQuery to provide dynamic content interaction. Additional macros are included like accordion, tablesorter, colorize and more.
    • JQuery Resources — This plugin provides a collection of JQuery resources that can be used by other plugins, providing a common point of deployment and configuration. Example feature include jquery forms, jquery ui, blockUI, tablesorter, jmap and more
    • Link Macro Plugin — Helps you customize page links in various ways.
    • Math (ASCIIMath) plugin
    • Page Family Tag Cloud — The page family tag cloud macro creates a tag cloud from labels attached to pages for specific page hierachy.
    • Universal Edit Button User Macro
    • User Status Role Plugin
    • Vault Plugin
    • Advanced Search Plugin — This plugin provides a set of macros utilising DWR (AJAX) searching capabilities. These macros center around providing a form-based interface for building search queries, the output is dynamically sortable and can be customised.
    • Approvals Workflow Plugin — The Approvals Workflow plugin integrates seamlessly with Confluence to provide an innovative way of managing workflows and content approvals, without compromising the open and collaborative philosophy of a wiki.
    • Remote Publishing Plugin
    • Booking Plugin — This plugin allows you to set up booking sheets.
    • Cache Plugin — Allows cache control of page-level elements.
    • Calendar Plugin — This plug-in puts a dynamically updated calendar into any page.
    • Checklists Plugin — A set of macros to generate checklist tables for a subset of pages (children of a given parent-page and/or filtered by a label). For each page, labels can be added/removed, values can be edited, and text segments can be added.
    • Cira Plugin — Cira is a set of macros that allows Confluence to be used as a basic issue tracking system.
    • Confluence Advanced Macros — This plugin provides many macros which generate content on Confluence content.
    • Confluence Attachments Macro — This plugin contains macros which display attachments (useful when attachment display is off by default).
    • Confluence Basic Macros — This plugin includes basic macros for linking and formatting content.
    • Confluence Compatibility Macros — This plugin contains macros for compatibility with other wiki systems (primarily with content imported from SnipSnap).
    • Confluence Dashboard Macros — This library includes macros that replicate the functions of the dashboard and space summary.
    • Confluence HTML Macros — This library contains macros that allow users to include raw HTML code within a page.
    • Confluence Information Macros — This plugin contains a few macros which can be used to to provide information blocks in Confluence (eg notes and warnings).
    • Confluence Tabular Metadata Plugin — This plugin contains a pair of macros which work with content labels to allow you to embed metadata into pages and blog posts.
    • Confluence User Lister Plugin
    • Content Publishing Plugin — The Content Publishing Plugin allows draft pages to be published in public Spaces. The public Space can be kept synchronized through a workflow using the Approvals Workflow Plugin, or manually.
    • Confluence Contributors Plugin — The Contributors Plugin contains macros to display contributors and statistics from a page or a set of pages.
    • Enhanced Tasklist — creates an enhanced TaskList
    • Exec Macro — Confluence macro to display output of executed commands or include local file content in a page.
    • Footnotes Plugin — A pair of Macros that allow you to create footnotes
    • Form Mail NG — A completely re-engineered version of the Form Mail Plugin. Hold no preconceptions; this is one small step for plugins, one giant leap for Confluence mailing.
    • HTML Plugin — Collection of macros for rendering HTML and related markup inside a Confluence page.
    • Include Random Macro — Plugin offers macros to randomly include pages and page excerpts
    • Index Glossary Plugin — contains 2 macros which can generate a index of word and a glossary.
    • Jasper Report Plugin — Allows Confluence users to compile, fill, show, and export a Jasper Report within Confluence pages
    • JavaBlackBelt Plugin — The JavaBlackBelt plugin shows the JavaBlackBelt (www.javablackbelt.com) status of one user, or of a list of users. Ideal for showing the status of your development team.
    • Java Scripting Plugin — Macros that allow page content to be created using scripting languages.
    • JIRA Graph Plugin — Confluence plugin that displays a graph of total issues per status over time, directly from a JIRA database
    • Job Manager Plugin — A Confluence plugin to view and manage the jobs registered by Confluence and its plugins.
    • Label Tools Plugin — A macro which allows you to ensure that pages containing it are given a predefined label
    • LaTeX Plugin — A plug-in for displaying LaTeX in Confluence.
    • Linking Plugin — This plug-in contains macros for linking to templates, the dashboard and other Confluence features.
    • Metadata Plugin — This plugin allows the user to attach metadata to any page in Confluence and to then generate reports and statistics using it.
    • Metadata Plugin 2 — Version 2 of the Metadata Plugin provides full metadata support for spaces, users, blog posts and attachments, as well as adding support for hierarchical spaces.
    • Multi-Excerpt Plugin — The multi excerpt plugin behaves like the excerpt macro, but allows for multiple excerpts, from multiple spaces.
    • Navigation Plugin — This set of macros displays links to pages within a specific hierarchy; currently {scrollbar} and (formerly) {noparent}.
    • NCBI aka Pubmed Literature Reference Macro — retrieves the article descriptions from Pubmed and renders them as literature citations (chicago-style)
    • New Code Macro — This is the Newcode Macro plugin. A plugin developed to serve as a replacement
    • Overlib Macro — The OverLib confluence macro is a wrapper around the OverLib JavaScript library.
    • Page Access Macros — contains two macros which allow you to display a list of users who have view access to the page or space in which the macros are included. Both macros can optionally take one parameter - the maximum number of users the list should display.
    • Page Flag Plugin — The page flag macro creates a check box on a page. The check box is linked to a label and metadata such that when the checkbox is changed,the label and metadata are also changed.
    • Page Information Plugin — The Page information macros allow you to insert various pieces of information about either the current page or a remote page
    • Confluence PageTree Plugin — embeds the ajax page tree found in the browse space content page
    • Pagetree Search Plugin — This plugin provides functionality to search a hierarchical page tree within a space.
    • Plugins Information Plugin
    • Portlet, Script, Hidden and TOC Macros — Macros for table of content generation, hidden content and easy extension point for scripts and portlets.
    • Pygments Code Macro
    • Replace and Render Plugin — Allows replacements to be made within a block of wiki markup
    • Reporting Plugin — This plug-in allows generation of powerful and flexible reports to be displayed on Confluence pages.
    • Scriptix — taps into the standardised scripting API that comes with Java 6 and provides a nice platform for writing what might be considered to be advanced user macros.
    • Slideshow Plugin — construct a PowerPoint-style slideshow inside a Confluence page
    • Space Access Macro — The space access macro provides a list of users that have at least view privileges to the space in which the page containing the macro is located.
    • Confluence Table of Contents Plugin — This macro generates a Table of Contents for the current page based on its headings.
    • Table Plugin — A collection of macros dealing with enhanced table capability in Confluence.
    • Tagcloud Macro — Displays a visual representation of the tags (labels) within a space, size representing frequency, and allows the user to click on each to access related pages.
    • Testplan Plugins — These plugins allow the user to write and maintain testplans within Confluence.
    • Zones Plugin — The Zones plugin provides a way to embed one wiki page (a zone template) into other wiki pages while substituting values into the template on the fly. The Zones plugin is an enhanced substitute for the Include Page macro. It provides functionality similar to MediaWiki's transclusions.
    • Confluence Markup Comments Macro — The Confluence Markup Comments Macro (CMCM) allows Confluence users, for the first time ever, to add "comments" in their wiki markup to make it more readable.
    • Insert Picture Plugin — A in-place image management widget for Confluence to help with image attachment manipulation
    • Sticky Notes and Snip-Edit Plugin — The Sticky Notes and Snip-Edit Plugin allows users to add notes on different sections of a page or blog post, and to modify any text excerpt.
    • Swimlanes - activity visualization — A hybrid java/flash plugin originally designed for visualizing student activity on a wiki, by providing a teacher in a class of wiki-using students a way to quickly get an impression of who's busy and doing what.
    • SimpleBlog
  • External Content — Macros and Plugins to include, wrap, embed, or otherwise expose external content within a confluence page, either from an attachment or an external url
    • 3DXML Plugin — This User Macro Plugin allows you to display and manipulate (scale, rotate, move...) 3DXML designs within Conluence page.
    • Amazon Web Services Plugin — Make money from Amazon while embedding colorful product pictures within your wiki pages by creating simple links to Amazon books, items, product searches, and wishlists.
    • Bamboo Plugin — The Confluence Bamboo plugin provides several macros that allow Confluence users to easily display data from Bamboo, such as the status of a particular plan's latest build.
    • Cache Macro
    • Collapsible Rss Macro — The collapsible rss macro allows you to insert an rss feed into a page (just like the normal rss macro) that each user can selectively hide until there is a new feed item to display.
    • Conflickr — This Confluence macro plugin helps you to integrate Flickr photos to your wiki pages.
    • Confluence JIRA 3 Plugin
    • EditGrid Plugin - Edit Spreadsheet in Confluence
    • Excel Plugin — Generate Confluence tables from Excel worksheets.
    • FeedBurner Plugin — View FeedBurner feed statistics in a Confluence page or via a special feed.
    • Flash Plugin — This macro is used to show flash based content in a confluence page.
    • Flash SWFObject Macro
    • FREE CRM Macro — The Go2Group Free CRM macro provides a method for Atlassian Confluence users to collaborate with teams using SalesForce.com or SugarCRM. The Go2Group Free CRM Macro allows Confluence users to view information from Salesforce or SugarCRM, allowing key customer information to be accessible immediately. By providing a synching mechanism between different teams, Go2Group helps keep customer management processes flowing by providing these users the information needed to make timely decisions.
    • FreeMind Plugin — Displays a Mind Map inline using FreeMind.
    • GanttProject plugin — GanttProject plugin enables generating and rendering Gantt chart from MSProject file attached to a wiki page.
    • Google Calendar Plugin — This plug-in allows the display of Google Calendars in Confluence.
    • Google Maps Plugin — A macro for including Google Maps of particular addresses within a page.
    • HTML Include Replace — Enables arbitrary HTML pages to be pulled into Confluence and automatically have relative and site-specific links rewritten so that images, scripts and style-sheets load etc.
    • Live LDAP Search Plugin — Plugin to enable live lookup of LDAP user details (and eventually more confluence specific info.
    • OPML Plugin — This plugin displays an OPML file in Confluence.
    • Presentation Macros Plugin
    • QualityCenter Plugin — This plugin allows you to display a list of QualityCenter issues within a Confluence page.
    • RSS aggregator macro plugin — Aggregates different RSS feed-s. If you wish to read all your favorite blogs in one place, this macro plugin provides a possibility to do this in a very simple way. All entries are gathered/displayed in one table and sorted by publishing date. If any RSS feeds can't be correctly processed then corresponding error information will be displayed under the entries table.
    • Salesforce.com Plugin — Integration of information in http://www.salesforce.com with Confluence.
    • SAP R3 Table Reader Plugin — Document your SAP R/3 customization within Confluence and keep it in sync with the backend system.
    • Snippet Plugin — A Confluence plugin to retrieve and display a snippet of text from a remote URL (e.g., Subversion).
    • SQL Plugin — Displays the result table or values from the SQL query on a Confluence page.
    • Twikkir - Twitter for your wiki! — In Twitter like fashion, Twikkir lets you publish your micro-blog within Confluence.
    • Updateable SQL Plugin — The updateable sql plugin was initially based on Bob Swift's SQL Plugin, but has evolved to be very different. It allows pages to send updates back to the database, in addition to displaying the results from the database.
    • UrbanDictionary Plugin — Simple plugin with macros which obtain definition(s) from Urban Dictionary via SOAP.
    • Visio plugin
    • Word Plugin — Include content from Word documents on a Confluence page.
    • Yet another Twitter macro — This user macro displays the latest five Twitter posts on a Confluence page.
  • Formatting Macros — Format or re-format content, manipulate style, reorganize display, but do not generate content de-novo
  • Games
  • Image and Visualisation — generate image content, either inline, attached or using 3rd party libraries or services
  • Other
    • Attachment Virus Scan and Blacklist Plugin — This plugin is based on Attachment Filter plugin http://confluence.atlassian.com/display/CONFEXT/Attachment+Filter and modified that admin can set up a backlist to control which type of files can not be uploaded, scan the attachment files before uploading, discard the attachment file and display error message if virus is found
    • Community Bubbles Plugin — Community Bubbles adds forums, social networking, portals, community management and a whole bunch of other stuff to your wiki to help highlight the presence of people and encourage them to interact.
    • Crucible Plugin
    • Plugins Usage Tracking — Allows the tracking of usage of the plugins deployed on this Confluence instance.  This plugin can help administrators to pinpoint plugins which can be safely disabled and/or uninstalled of a Confluence instance. It also allows to know where a particular macro is used.
    • Simple LDAP Authenticator — The Simple LDAP integration allows the to integrate Confluence with an LDAP Server for authentication only, while keeping all user and groups information in the local Confluence DB - similar to whats possible with JIRA.
    • zAgile Wikidsmart (Confluence semantic wiki) — Turns Confluence into semantic wiki; enables interoperability with other applications such as Jira, Subversion, and others. Capture information in forms with semantic annotation.
    • Access Manager (Sun Identity Server) custom Seraph authenticator for Confluence
    • Archiving Plugin — It effectively automates content archival processes, and prevents your wiki spaces turning into scrapyards.
    • Attachment Checkout Plugin — Automatic Undo Check-out functionality is implemented.
    • Autowatch Plugin — This plugin allows administrators to specify that any contributors to a space watch their contribution automatically.
    • Confluence Blogging RPC Plugin — The Blogging RPC Plugin implements the Blogger 1.0 API and the MetaWeblog API for Confluence to let you post Confluence news pages from any client that implements these APIs
    • Copy Space Plugin — The copyspace plugin allows a space administrator to copy a space, including the pages within the space, but excluding (so far)page history, blog posts and email.
    • Edit Dashboard Plugin — allow you to edit a html section for Home page of each space.
    • Link Validator Plugin — This plugin checks links to see if they are valid.
    • Confluence Mail Page Plugin — Enables a page to be emailed to specified email addresses, users or groups.
    • Mark for Review Plugin — Allows users to mark pages for review by moderators.
    • Podcasting Plugin — This plugin allows the creation of Podcasting feeds based on Confluence pages and news items.
    • PrintBasket Plugin — add a printing basket which allows you to make a selection of pages and to print them at one time
    • Recently Updated Portlet — The Recently Updated Portlet is a JSR-168 compliant portlet that can be used to display Recently Updated Confluence Pages on portal software.
    • Search Portlet — The Search Portlet is a JSR-168 compliant portlet that can be used to search a confluence server.
    • Confluence Social Bookmarking Plugin — This plugin provides social bookmarking functionality allowing users to create and share bookmarks in a Confluence instance.
    • Stats Links Plugin — add a link in "browse space" menu which leads to a page where you can find some statistics and a list of links of the space.
    • Subconf — Plugin that allows subversion to act as the attachment store for Confluence, with 2 way synchronization.
    • TagLinks — Allows pages whose titles match a pattern (<id>.<id>.<id>...) to be handled hierarchically, by automatically storing them as children of higher-level pages and rendering any reference to them as links, without having to explicitly declare them as such using '[' and ']'.
    • User Information Plugin — This plugin replaces the Confluence user profile actions to allow users to enter more information about themselves.
    • WAP Plugin — This plugin allows access to Confluence using cellular phones supporting WAP 2.0.
    • Confluence WebDAV Plugin — Use Confluence like a network drive with drag and drop file operations.
    • Confluence Usage Tracking Plugin — A macro for tracking content view, create, edit and delete events in Confluence.
    • Agile Toolkit Plugin - Planning Poker and Simple Taskboard — The agile toolkit contains a set of plugins that support agile techniques like Planning Poker and Taskboards. It will continue to expand as demand dictates.
    • Confluence AppLinks Plugin
    • Confluence Shared Access Layer Plugin
    • title
  • Prototype Macros — placeholder or proof-of-concept macros which may be incomplete, buggy, dangerous, or otherwise unsupported
  • Scaffolding Plugin — This plug-in contains macros for creating 'permanent templates' and editable forms.
  • User Feedback — Macros and plugins used to solicit user feedback
    • Form Mail Plugin — A macro for presenting the user with an AJAX form-mail UI which they can email you with messages.
    • Questionniki Plugin — Questionniki enables Confluence users to collaboratively author a questionnaire and to put the resulting questionnaire online.
    • Ranking Macro — Yet another macro for voting/rating/ranking pages, this one is uniquely different to the others by providing a macro for ranking pages with a 'was this page useful' style approach, tracking only positive answers
    • Rate Macro — A set of macros for collecting and displaying page ratings.
    • RSVP Plugin — The RSVP macro provides a slick interface allowing to RSVP to upcoming events.
    • Survey Macro — Like the vote macro but need to collect data and comments on many issues at once? The Survey Macro is perfect for performance reviews and multi-question surveys.

Labels

macro macro Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (5)

 

  1. Feb 05, 2007

    James Mortimer says:

    I've started to move these around as discussed previously: simple content (unde...

    I've started to move these around as discussed previously:

    simple content (under-construction) - usually shorthand for code that can be done in regular wiki
    compound content (edit-include) - shorthand macros that require other macros or plugins
    complex content (metadata / footnotes / multi-excerpt)
    dynamic content (dynamic table, calendar, tasklist)
    user feedback (vote, rate, rsvp)
    confluence content (contributors, glossary, versions, userlister)
    external content (word / flash / excel / conflikr / graphviz / ncbi ) - link to or render external, inline or attachment content. this can be broken into those that require a third-party installation (esentailly, the macro is a wrapper for another product) and those that work out-of-the-box
    prototype (sub-section) - neat macros only meant as proof-of-concept but may still be useful
    low-level macros (sql / run / portlets etc / cache / html / scripting) - fundamentally change capabilities of the wiki and requires careful consideration and usage
    Images/visualisation (gliffy/jmage/chart/etc)

    We should perhaps also consider harmonizing with confluence internal macro categories, currently:

    Text Formatting
    Headings
    Text Breaks
    Links
    Lists
    Images
    Tables
    Advanced Formatting
    Confluence Content
    External Content
    Misc
    Macros

    with the macros section, of course, being more diverse.

    1. Feb 15, 2008

      Brian M. Thomas says:

      .mycenter { font-size=150%; } O Cobbler, why do your children go baref...
      O Cobbler, why do your children go barefoot?
      or
      In a wiki that has labeling deeply integrated into its content,
      why are its authors struggling with hierarchical taxonomies for their own pages?

      Seems you could multiply index these things using labels, and save yourself the headaches and soul-searching...

      1. Feb 15, 2008

        David Peterson [CustomWare] says:

        A valid point.

        A valid point.

      2. Nov 11, 2008

        James Mortimer says:

        That could work very nicely, except that it wasn't being done. The pages are n...

        That could work very nicely, except that it wasn't being done.

        • The pages are not labelled, or at least not consistently. The 'bag of macros' was getting quite large.
        • putting in place a first-level heirarchy does not exlcude using labels in the future, but gives a immediate cue that your macro should at least be categorized. uncategorized macros are at the top level. This way, we encourage at least one level of categorization.
        • Further levels would be desirable. Can anyone suggest a page layout or modification to this page that would encourage people to tend towards order rather than disorder, by adding appropriate labels to the macro? Is there an easy way to do this? I use the Checklists Plugin on our site, for example, to quickly add/remove specific labels from pages.

        Whether we categorize using heirarchial child-pages, or non-heirarchial labels, or both, we still need to do several things:

        • define, and agree to, useful and meaningful 'categories'
        • actaully assign the categories to the macros
        • explain or show how to assign a category, so that the work of categorization can be shared with new-comers
        • provide a way to determine which items require further categorization

  2. Jul 01

    Corey Connors says:

    I'm building a new 3.0 site using the left-nav theme - how do I get there to be ...

    I'm building a new 3.0 site using the left-nav theme - how do I get there to be an obvious "help" button?  My user like being able to browse the macros and such...