Button

The Button macro allows you to create stylized buttons that hyperlink other pages or websites. These can be added individually anywhere on a page or grouped as a horizontal row of button links using the Button Group macro.

Although hyperlinks can be created through the standard Confluence interface, buttons provide stronger visual integration with the application as a whole. They can be used to create pages that feel like part of Confluence itself.

Add a Button to your page

1. Navigate to the page you want to edit.

2. Select the Edit icon.

3. Select the position where you want to display your cards.

4. Type /Button and select the Button macro.

5. In the button editor:

   1. Select one of the button presets for a quick starting point

   2. Customize your button by changing the appearance, alignment, and destination for your button.

6. Select Save. A macro placeholder is shown on your page.

7. Select Publish to see your button in action. 

Edit your button

To change the macro, click the macro placeholder, then click the Edit icon.

Make your changes, then select Save.

 Add a destination to your Button

You can use a button to link to a Confluence page on your site or to an external webpage. 

Link to a Confluence page on your site

In the button editor select Search Page, then type in the Confluence page field. The field will search for matching Confluence pages, which you can then select from the drop-down. To only see pages from the same space select the check box above the search box. 

Link to a URL

In the button editor, select Add Link, then type the full web address in the Enter URL field.

Link a button to a specific place on a page

You can combine the button macro with confluence's anchor macro to link to a specific point on a page. 

Link to a location on the same page

1. Add an anchor macro to the page.
2. Give the anchor macro a name eg. notes.
3. Use the name of the anchor macro as the Destination for the button macro. Do this by putting #name. eg #notes.

Link to a location on a different page

1. Add an anchor macro to the page.
2. Give the anchor macro a name eg. notes.
3. In the Destination field of the button macro, select the page with your anchor macro. Then, add the name of the anchor to the end of the URL.
   eg.  sitename.domain/wiki/Project+seven#notes

Open a new tab with your Button

If you don't want readers to leave the page when they click on a button, you can make it open a new tab when selected. To do this, select the Open in a New Tab check box.

Change the alignment of your Button 

There are three options for aligning your button: Left, Centre, and Right. You can select these options in the Button editor. 

Change the appearance of your Button 

There are two ways to change the appearance of your button. You can use one of the preset button types to quickly change your button style and get a new look and feel. Or you can design it yourself using the Customization tab. 

Change your Button text

Changing the text on your button is easy. Simply select the Button text field and enter the text for you need. If you don't want any text you can choose to only have an icon instead.

Add an icon to your Button

You can add an icon or emoji to your button to help show what it is for and to add some personality to your buttons. To add an icon select Add icon from the editor.

This opens the icon and emojis libraries. You can select any icon from the libraries. 

You can change an icon after adding it to a Button. Select the pencil icon to choose a different icon. Select the trash icon to remove it.

Change icon position 

The icon position parameter lets you choose where the icon will appear. The options are:

Choose a Button style

There are four different styles to choose from. Each button style has its own hover state to highlight the button before a user clicks on it. The style options are: 

Change your Button shape

There are three options for how rounded your button is. Select your choice from the Shape field.

Change your Button size

Choose from Small, Medium, and Large for your button size.

Select the Full Width checkbox to make the button fill the full width of the space it is in. This is a good option when using buttons inside a table or Background macro.

Change your Button color

Using color palettes, you can customize the color of the background and text to be exactly what you want. You can select from one of the options shown. If you don't see the color you want, select the Paint bucket button to open a color picker and choose any color.

Related Macros

• Button Group
• Background
• Advanced Cards
• Interactive Banner