User macros are short pieces of code that perform an often-used function or add some custom formatting to a page. People can call the macro into action by adding the macro keyword to their Confluence pages. You can write a 'user macro' by adding code on a screen in the Confluence Administration Console.
Notes:
- You need System Administrator permissions in order to perform this function.
- See Shared User Macros for a list of community-donated macros.
Be careful when installing user macros from unknown authors.
- If you remove a user macro that is in use on Confluence pages, you will need to remove the macro from the pages manually. When you remove the user macro, the usage of the macro on the page will become invalid. Hint: Use the Confluence search to find all occurrences of the macro on pages and blog posts.
To add a user macro,
 - Click 'User Macros' in the left-hand panel.
- Click the link on the text 'Click here to create a new User Macro' at the top of the list of macros.
- Enter the macro details as explained in the guide to writing user macros.
- Click the 'Save' button.
|
To edit a user macro,
- Select 'User Macros' in the left-hand panel. This will list the currently configured user macros.
- Click 'Edit' next to the relevant macro.
- Update the macro details as explained in the guide to writing user macros.
- Click the 'Save' button.
|
To remove a user macro,
- Select 'User Macros' in the left-hand panel. This will list the currently configured user macros.
- Click 'Remove' next to the relevant macro.
|
RELATED TOPICS
