Button Group

Used in conjunction with the Button macro, the Button Group macro allows you to create stylized button groups. You can create a horizontal toolbar-like group of hyperlinks or a vertical page tree-like group.

Add a Button Group macro to your page

  1. Navigate to the page that you want to edit.

  2. Click the Edit icon.

  3. Click Insert > View More in the Confluence editor.

  4. Select the Button Group macro in the Select Macro screen.

  5. Choose the direction of the buttons from the Button Group Direction dropdown. They can be Vertical or Horizontal. The default is horizontal.

  6. Choose your preferred Button Group Alignment. They can be Left, Centre, or Right. The default is Left

  7. A macro placeholder is displayed.

  8. Insert a Button macro for each button you want to add into the macro placeholder, e.g. add a Button macro for Email, Search, and Edit. Buttons are arranged in the order shown within the Button Group macro. You can change the order later by dragging the macro placeholders to the desired positions.

  9. Click Publish to view the Button Group rendered with the button links. In the example below, standard, primary, and subtle style buttons were added to the Button Group.

  10. Click the buttons to test the link destinations and behaviors, e.g. if they open in a new tab.

Direction Examples

Horizontal Direction

Vertical Arrangement

Edit the macro

To make changes to the macro, for example, to add or remove a button or to change the tooltip text, click the Button Group macro placeholder then click the Edit icon. Make the required changes, the changes save automatically.

Video Walkthrough

Watch our video walkthrough to see the Button Group macro in action.


Related Macros


On this page