Confluence 2.10 has reached end of life
Check out the [latest version] of the documentation
Macros allow you to perform programmatic functions within a page, and can be used for generating more complex content structures. Generally speaking, a macro is simply a command wrapped inside curly braces {...}.
Macro libraries are collections of macros which may work together or provide common functionality. They also allow groups of macros to be enabled or disabled together. (Added in Confluence 1.1).
Confluence comes bundled with a host of useful macros, but users can also create their own macros to do specific things.
Between Confluence 1.2 and 1.3, macros were made a part of the Confluence plugin architecture, with each macro being a plugin module. As such, the configuration files needed to configure a macro for Confluence have changed. Follow this link for information on converting between 1.2 macro libraries and 1.3 plugins
Created a new macro or looking for macros?
Share your macros and find new plugins in the Confluence extensions space.
More Information
- Guide to Confluence Macros - a list and usage examples of the macros that come bundled with Confluence
- User Macros - how to create simple formatting macros inside Confluence in real time.
- Macro Plugins - how to extend Confluence with more complex macros written in Java
- Documenting Macros - You haven't finished writing your macro until you've documented it!
- User Contributed Macros - Macros written by other Confluence users
Old Information
The following pages describe how to write macros for Confluence 1.1 and 1.2. This information is not relevant to users of Confluence 1.3.
- Macro Management - obsolete - enabling and disabling individual macros and entire libraries.
- Custom Java Macros - obsolete - creating more complicated custom macros using Java, including a worked example.
