Buttons for Confluence is a pair of macros that enable you to create stylized buttons with hyperlinks to other pages or webpages. These can be added individually anywhere on a page using the Button macro or grouped as a horizontal row of buttons by including the Button Group macro.

These macros can be used in either Confluence's new Cloud editor or the legacy editor.

Instructions

  1. Navigate to the page you want to edit.
  2. Click the Edit icon.
  3. Click Insert > View More in the Confluence editor.
  4. Select the Button macro in the Select Macro screen.
  5. Customize the button using the following parameters:

    Parameter
    Description
    Default
    Required
    TitleThe text that is displayed on the buttonnone
     

    DestinationThe page (URL or file) that the user is directed to when they click the button. The field auto-completes for pages withing the Confluence site, but can also take a full URL or file link such as
    file:///c:/read_me.txt.
    none    
    Button TypeSelect the type of button that you want to display:
    - Standard
    - Primary
    - Subtle

    The effect on these buttons will differ depending on whether they are on their own, or part of a Button Group.
    standard 
    IconSelect an icon option:
    - None: no icon is displayed on the button.
    - Preset: Select from a list of Confluence icons.
    none 
    Open Hyperlink in a New TabOption to display the link destination in a new tab. off 
  6. Click Preview to see how the button will appear on your page, and make any desired changes.
  7. Click Insert. A macro placeholder is displayed on the page.
  8. Click Publish to view the rendered button on the page.
  9. Click a button to test the link destination and behaviour, e.g. if it opens in a new tab.
Button Type Styles
Standard
Primary
Subtle

Instructions

  1. Navigate to the page 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. Enter an optional title for the group which is displayed as a tooltip to users when they hover over the button, e.g. Click an option.
  6. Click Insert. A macro placeholder is displayed.
  7. Insert a Button macro for each button that you want to add into the macro placeholder, as described in the Button macro instructions. For example, you can insert a Button macro for Email, Search, and Sign Up.
    Buttons are displayed in the order in which they are added to the Button Group macro. You can change the order by dragging the Button placeholder to the desired position.
  8. Click Publish to view the Button Group rendered with the button links.

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, then click Save.