Skip to main content
Kolekti home
How to make links more engaging with Confluence buttons
Share on socials

How to make links more engaging with Confluence buttons

A headshot of Zoriana Bogutska against a teal background
Zoriana Bogutska
Published: 26 March 2025
Last updated: 1 December 2025
6 min read
Two brightly coloured buttons on a stylised background with an arrow hovering over the left button
A headshot of Zoriana Bogutska against a teal background
Zoriana Bogutska
Published: 26 March 2025
Last updated: 1 December 2025
6 min read
Jump to section
What are buttons?
How to create buttons in Confluence
- Create a single button
- Create a group of buttons
How to customise buttons
Why use buttons in Confluence?
4 ways to use buttons on your pages

Ready to create a better navigational experience for your users? With Confluence buttons, the solution is literally at your fingertips.

If you want to create the best Confluence pages, buttons are an ideal tool to have in your arsenal. With very little effort, the humble button can elevate content to be more user-friendly, engaging, and action-oriented.

So, let’s talk about how to create buttons in Confluence.

What are buttons?

Buttons are a more engaging way to present hyperlinks. They’re interactive, eye-catching elements that help guide users through your content. You’ll often find them on forms and on webpage navigation menus.

In Confluence, buttons help create a more user-friendly and interactive experience by improving navigation and encouraging users to click through to important pages. They’re ideal for a wide range of uses, from a team hub to a Confluence knowledge base.
Three brightly coloured buttons in a row with a cursor hovering over the right button

How to create buttons in Confluence

Because Confluence doesn’t have a built-in button feature, you’ll need an app from the Atlassian Marketplace. You have two choices:

  • Buttons for Confluence: A dedicated app for creating and grouping buttons on your pages.

  • Mosaic: Content Formatting Macros & Templates: An all-in-one macro toolkit that includes the Button macro, Button Group macro, plus many others like Tabs, Advanced Cards, and Backgrounds to help you build more engaging pages.

Try both apps free for 30 days and see which works for you:

Create a single button

  1. In the Confluence editor, type "/button’" and choose the Button macro.
  2. Choose a preset or click the "Customization" tab to start from scratch.
  3. Add your button text, choose a destination for your button to link to, and customise your button’s appearance.
  4. Click "Save" in the editor, then select "Publish" or "Update" in the top right corner of your Confluence page.
Pro tip: Want to link to a specific location on your page? Add a Confluence anchor macro to your destination page, give the anchor a relevant name, then use the #name in the "Destination" field of the Button macro editor (e.g. a "Notes" section could be referred to as #notes).

You can even link to a specific spot on a different page this way by preceding it with the full page URL (e.g. linking to the notes sitename.domain/wiki/Example+project#notes).

Create a group of buttons

You can also group buttons so they sit neatly next to each other. Here’s how:
  1. Create your buttons as usual, following the steps above for each.
  2. On your page, type "/button group" and select the Button Group macro.
  3. In the Button Group editor, choose the group’s alignment and direction (horizontal or vertical).
  4. Press "Save". You should be able to see the Button Group macro placeholder on the page.
  5. Finally, drag each Button macro into the Button Group macro placeholder.
  6. Publish or Update the page to see your grouped buttons.

How to customise Confluence buttons

You can customise your buttons in a variety of ways from the editor window:
A browser window showing various options for customising Buttons within the Confluence Button editor
You can customise:

  • Button icon: Optional but helpful for creating engaging buttons, choose an emoji, or pick an icon from Atlassian, FontAwesome, or Material Design.

  • Button alignment: Align your button left, centre, or right on your Confluence page.

  • Background colour and text colour: Choose from your brand palette (if you have Mosaic's Advanced Edition), recently used colours, or default macro colours for the background and text.

  • Button style preset: Select a pre-designed button template to get started quickly.
A row of four Buttons in a range of background colours and with varying icons

Why use buttons in Confluence?

  • Boost page navigation: Link to other Confluence pages in a visually striking way, helping users move between related content with ease.

  • Provide clear Call To Actions (CTAs): Need users to take a specific action? A button is the best way to encourage clicks on form submissions, starting guides, and more.

  • Boost user engagement: The visual, interactive nature of buttons draws attention and keeps users engaged in a way that plain links can’t.

  • Improve brand consistency: Using your organisation’s colours is a great way to make your Confluence pages look more professional and on-brand.

Ways to use buttons in Confluence: 4 examples


Create a well-connected knowledge base

Two vertically stacked buttons letting users log in or sign up on a calming background
Create a central hub for your knowledge base by using buttons to guide users to popular topics or frequently asked questions.

For extra visual impact, you can embed your buttons inside a Background macro from Mosaic to create a stylish header section from your links.

Make company hub links more professional

Three light blue sections in Confluence, side-by-side, with each section containing a black button
On a company hub, buttons are perfect for directing employees to important resources, such as the staff directory, IT support, or HR policies. You can even embed your buttons within separate Background macros - formatted with layouts - to create engaging side-by-side sections.


Signpost resources on a product battlecard

A column of four navy full-width buttons beside a table displaying an update log
When creating a sales or marketing battlecard, use a two-column layout to keep everything organised. In one column, use a set of buttons for quick links to key resources like competitor benchmarks, demos, sales enablement materials, and case studies.

In the other column, you can add useful at-a-glance data, such as an update log, to track changes and keep your team informed.


Provide clear CTAs on a change management plan

Two columns with dark navy backgrounds, with a list of five white buttons in the right-hand column
When outlining a proposed change, use buttons to create an interactive contents section. This allows stakeholders to quickly jump to the information they need, whether it's the Roadmap, Cost and Considerations, or the Communications Strategy.
Ready to transform your Confluence pages? By making your links more interactive and visually appealing, buttons are a simple but powerful way to improve navigation and guide users to the right information. Try adding buttons to your pages today and see the difference it makes!
A purple chain link icon inside a white circle

Level up your page design with Buttons and more


Mosaic gives you all the tools to create interactive, engaging pages.
Try it now with a 30-day free trial:
Written by
A headshot of Zoriana Bogutska against a teal background
Zoriana Bogutska
Senior Product Marketing Manager
Zoriana has over 12 years of experience in marketing, with 6 of them in product marketing management. As a Senior Product Marketing Manager, Zoriana aims to ensure Kolekti's apps excel by understanding customer needs, solving their problems, and making Kolekti truly the best solution.