Skip to main content
How to create engaging pages with Confluence Cards
Share on socials

Create engaging pages with the Confluence Cards macro

A headshot of Zoriana Bogutska
Zoriana Bogutska
25th March, 2024
A Confluence page formatted with brightly-coloured sections
A headshot of Zoriana Bogutska
Zoriana Bogutska
25th March, 2024
jump to section
How to use cards in Confluence Cloud
1: Built-in Cards macro
2: Advanced Cards macro
Ways to use Confluence Cards

Ready to transform your workspace, boost navigation, and enhance team engagement with Confluence cards? Our guide will show you how.

Reading long, text-heavy Confluence pages can sometimes feel overwhelming. Enter the Confluence Cards macro - a quick and easy feature to help you create the best Confluence pages.
Cards help you create more visually appealing, engaging Confluence content. In this post, we'll explore how the Cards macro can make Confluence pages more user-friendly and easy to navigate.
A gif cycling through various Confluence Cards macros in different layouts and styles
Various types of Confluence cards created with the Advanced Cards macro

How to add Cards in Confluence Cloud

There are two different ways to create cards depending on your needs.
  • For a simple card solution (and if you have access to Confluence's beta features), try Option 1.
  • If you want more customisation and advanced features (such as more than three cards in a row, or your own images on cards), try Option 2.

Option 1: Confluence’s built-in card macro (beta)

1. Click the Edit icon (the pencil) in your chosen Confluence page.
2. Start typing the /cards shortcut on the page, then click Cards [Beta] to add it to the page.
The Cards shortcut typed on a Confluence page with a dropdown showing the Cards macro
3. In the sidebar, configure the following:
  • The card size, alignment, and type (text-based or visual)
  • The title, description, image, and link (if applicable) for each card
Three colourful cards in Confluence with the configuration options on the right

Option 2: Advanced Cards Macro

The Advanced Cards macro (included in Content Formatting Macros for Confluence Cloud) lets you create visually appealing, card-based layouts on a Confluence page. Advanced Cards offers more customisation options than Cards. You can:
  • Change card colour
  • Have more than three cards in a row
  • Upload your own images
  • Choose more flexible layouts
A gif of a cursor clicking options to change the layout in the Confluence card macro editor

To use Advanced Cards:

2. Head to your chosen Confluence page, then click the Edit icon (the pencil) in the top-right of the page.
3. Click where you want to display your cards and type “/cards”. Select the Cards macro.
A gif of a user typing the shortcut for the Cards macro on a Confluence page
4. Use the Cards macro editor to customise your cards however you want.
  • To customise the overall card options (e.g. the layout of the cards), select the “All cards” tab.
  • To customise a specific card (e.g. its colour scheme), click the “Selected card” tab.
  • To add a card to the row, click the “Add card” button in the left-hand preview.

To delete a card from the row: Hover over a card in the left-hand preview and click the trash can icon.
A gif of a user clicking through different formatting options in the Confluence Cards macro editor
5. Click the “Save" button on the Cards macro editor. You should see a macro placeholder on your page.
6. Click the “Publish” button on the top-right of your page to see your brand new Cards macro!

Ways to use Confluence Cards

Now that you've seen what Cards have to offer, what are some ways to give the most value to your users?

Let's explore some examples, using the Advanced Cards macro to illustrate.

Create profiles to highlight members of the team

A Confluence team page is a great place to showcase who your team members are and what they do. With the Cards macro, you can create visual profile cards to help users identify individuals on the team and how to get in contact at a glance.
Four cards in a row with user images and their job roles underneath

Create a visually appealing set of navigation links

While there are different ways to add navigation links and buttons to a Confluence page, they're often scattered and have limited context. This can negatively impact user engagement. With the Cards macro, you can display multiple links in one central place and even show a preview of the page you’re linking to.
A gif of a cursor hovering over three different cards in a row to enlarge them
Love the Cards used in these examples?

Copy the Advanced Card macro used in our templates to get your pages set up quicker:

Make your Confluence knowledge base more user-friendly and engaging

A Confluence knowledge base is a central information hub that helps users quickly find the answers they need.
However, creating a great knowledge base is no simple task. Good structuring and navigation help users to easily visualise and digest information at a glance. The Cards macro is a great way to draw attention to the most content on a page and highlight text in Confluence.
A screenshot of a knowledge base in Confluence Cloud with three visual Cards macros
​​And there you have it - all the features, benefits and uses of the Card Macro to help you create better and more engaging Confluence content!

Discover the Advanced Cards macro in Confluence Cloud

Get a free month of Content Formatting Macros and create beautiful, engaging pages today.
Written by
A headshot of Zoriana Bogutska
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.

LinkedIn →
Content Formatting