This page last changed on Jan 17, 2007 by rosie@atlassian.com.
Old Documentation

This documentation refers to Confluence 1.1 and 1.2. As of Confluence 1.3, macros have been incorporated into the plugin system. For information on how to manage plugins, read Installing and Configuring Plugins manually.

Since Confluence 1.1, users can enable and disable macro libraries and individual macros through the web interface.

To manage macros, go to Administration then Manage Macros.

You must be a Confluence administrator to manage macros.

Here is an example of the Manage Macros screen:

From this screen you can see:

  • Libraries - There are 4 macro libraries installed (Basic, Compatibility, Advanced and HTML macros). There is also the special User Macros library, see User Macros for more detail on how to create your own user macros.
  • Disabled libraries - The Compatibility and HTML macro libraries are disabled here. You can see that because their tabs are greyed out. A disabled library is installed in Confluence but not usable within any page.
  • Selection - The Basic macro library is selected, and 6 out of it's 7 macros are enabled currently.

Disabled macros or libraries

You can disable individual macros or entire libraries through this macro management interface.

A disabled macro will not be usable within Confluence. If it is used, a simple error message will be printed and the macro will not be run. For a disabled library, none of it's macros will execute.

For example in the screenshot above, the Compatibility and HTML macro libraries are disabled - their tabs are greyed out. Also, in the selected Basic macro library, the noformat macro is currently disabled - it has a red background rather than a green one.

Enabling and Disabling

To disable a macro - locate it's macro library, then click the 'disable' link next to it.

To enable a macro - as above, except click the 'enable' link.

To disable a library - click on the enabled library's name in the tab list on the left of screen, then click 'Disable library' at the top.

To enable a library - click on the disabled library's name in the tab list on the left of screen, then click 'Enable library' at the top.


manage-macros.gif (image/gif)
Document generated by Confluence on Dec 20, 2007 18:52