Buttons and links are the standard forms of communication between the user and the system. In fact, they are vital in creating interactions and providing a good UX. After all, these features make it possible for users to move about, take action or make a decision with a single tap.

MacroSuite - Button

But that's not all, though! Adding a button to the page gives it a more eye-popping appeal since they usually have the highest emphasis on the web (or any other) page. But there's more to it than meets the eye. Buttons are one of the most effective ways to increase conversions, whether from one page to the next or to your chosen goal page. The same goes for Confluence pages. And this is precisely why it's crucial to include these features.



How to use

To add the Button macro to a Confluence page: 

  • Choose “+” in the Confluence editor

  • Search “button” and select the MacroSuite - Button.

Alternatively, type '/' on the Confluence page to see a list of suggestions and type 'Button.' Intuitive configuration dialogue helps users to create and customise buttons fast and easily.

Add label here

Use an inline editing feature and seamlessly edit the content of your button. Write your button copy directly on-screen and make quick changes with one click. The character limit is 40.


Click on icon and choose from more than 5000 icons available and attract even more attention with Atlassian built-in emojis. To change the icon position or remove label, use the “Icon” dropdown in the macro configuration.

Button Width

Use the slider to change the button width. It will add space inside the button.

Button Radius

Use the slider to round the edges of your button.


Activate shadow with selecting one of the four predefined shadow styles: Inner shadow, outer shadow, drop shadow and neumorphism.


Choose a fill, font, hover, icon and border colours from the Atlassian primary and secondary colour palette. If you want to add more colours, use the HEX editor.

Button Link

Add links to Confluence content (pages and attachments) and external URLs, giving them a more polished look. Use the email tab to open the mail client with the click on the button.


Templates and Library

MacroSuite Button macro's got you covered with its Templates. If having too many options overwhelms you, just pick one of the available Button templates and add a pre-designed button to your Confluence page.

Our UX/UI teams works on more button templates and categories. It is not possible to change or delete predefined templates. Use the library feature to create and maintain the company design guidelines.

If you want to save your custom-designed Button, you can do so easily by adding it to the Library. Additionally, saving your Button to the Library makes it accessible to everyone on your team. So, don't lose it even if you don't use it! Save it for later and help your teammates overcome their creative blocks.


Not all Confluence users have permissions to save created buttons to library. Open MacroSuite styleguilde and add users/groups that can create library buttons from the dialogue. Confluence admins have all permissions enabled.

Add permissions



The button will receive updates to improve performance and user experience. We will introduce the following features soon:

  • Create a ticket in Jira with a click on the button

  • Upload and use icons

  • Company colors RELEASED!

  • Button library (Save button) RELEASED!

  • User permissions to save button RELEASED!

  • More icons RELEASED!

  • Button shadow RELEASED!

  • Hover options RELEASED!

If you have any questions, need more detailed information, or want to share feature suggestions, please feel free to contact us via our service desk.


How to create Buttons with Easy HTML macro

Button group

Social media buttons

Download Buttons

Loading buttons


MacroSuite News