The Button macro allows you to create AUI-styled buttons which provide hyperlinks to other pages or websites.
Although hyperlinks can be created through the standard Confluence interface, the Atlassian styled button hyperlinks provide stronger visual integration with the application as a whole, and can be used to create pages which feel like part of Confluence itself.
Click Insert > Other Macros.
Select the Button macro from the provided list.
Complete the following details.
The text which will appear on the button.
The page, URL or file (see note below) which the user will be directed to when they click the button.
The field will auto-complete for pages within the Confluence site, but can also take a full URL or file link (file:///c:/read_me.txt). You may also specify an email destination, e.g.
Some browsers may block URL paths that point to files on a local files system or local networked folders for security reasons. This can be overridden in your browsers security settings, but should only be done as part of a comprehensive security strategy.
In most cases, it is best to host such files on dedicated web servers that use other protocols such as FTP. More info can be found in Atlassian's documentation.
Select the type of button to be displayed:
The effect on these buttons will differ depending on whether they are on their own, or a part of a Button Group.
Select an icon option:
|Custom AUI Icon||Add the name of desired AUI custom icon as defined in docs.atlassian.com.|
Note: icons available are AUI version dependent.
|ID||Specifies a CSS ID to be added to the button.||string||none|
|Class||Specifies a CSS Class to be added to the button.||string||none|
The macro will then appear on the page.
Once saved, an Atlassian styled Button will appear on the page.
Icons may look slightly different depending on your version of Confluence.