Love the cards used in these examples?
Get Mosaic free for 30 days and try Advanced Cards for yourself:
Create engaging pages with the Confluence Cards macro
Share on socials
Create engaging pages with the Confluence Cards macro
Jump to Section
Jump to section
How to add cards in Confluence
1: Built-in Cards macro
2: Advanced Cards macro
- Customise your Advanced Cards
Ways to use Confluence Cards
Ready to transform your pages, boost navigation, and improve engagement with Confluence Cards? Our guide will show you how.
Long, text-heavy Confluence pages can feel overwhelming and make it hard for users to find the information they need. Enter the Confluence Cards macro, a simple feature that helps you to create the best Confluence pages with visually appealing content.
In this post, we'll explore how Confluence Cards can make Confluence pages more user-friendly and easy to navigate.
In this post, we'll explore how Confluence Cards can make Confluence pages more user-friendly and easy to navigate.
Option 1: Confluence’s built-in card macro
1. From your Confluence page, click the the Edit icon (the pencil).
2. Type /cards and select Cards to add the macro to your page.
3. Use the sidebar to configure your Cards. You can choose the size and alignment, and set the content to be either Manual (linking to specific pages) or Dynamic (displaying pages based on filters like space, label or owner).
You can then also configure how many cards to show and whether to display the page owner, when the page was last updated, and the page description.
Option 2: Advanced Cards macro
The Advanced Cards macro (included in Mosaic: Content Formatting Macros & Templates) offers far more customisation options, allowing you to create visually appealing, card-based layouts on a Confluence page. With Advanced Cards, you can:
- Change the card colour to match your brand
- Arrange more than three cards in a row
- Upload your own images and icons
- Choose from more flexible layouts
To use Advanced Cards on your pages:
- Install Mosaic (you can try it free for 30 days).
- In Edit mode, type “/advanced cards” and select the macro.
- Use the editor to add cards, change the overall layout, and customise individual cards with different colours, text, links and images.
- Click Save on the macro editor, then select Publish or Update in the top-right of your page to see your brand new cards in action!
How to customise your Advanced Cards:
- To change the overall card options (e.g. the layout of the cards), select the 'All cards' 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.
- To customise a specific card (e.g. its colour scheme), click the 'Selected card' tab. You can change its background and text colour, heading and description, link, and image.
Ways to use Confluence Cards
Now that you know how to create cards, what are some practical ways to use them? Let's explore a few examples using the Advanced Cards macro.
Create profiles to highlight members of the team
A Confluence team page is a great place to introduce your team members. With cards, you can create visual profiles that highlight each person’s role, responsibilities, and contact information, making it easy for others to know who to contact.
Build a more engaging onboarding hub
Help new starters get up to speed by creating an onboarding page with cards that link to key resources. You can create cards that link to company policies, benefits information, setup guides, or checklists to help employees quickly get up to speed.
Make information stand out on a product homepage
Instead of a long list of links, use cards to create a visually appealing homepage for your product or project. Create cards that link to your roadmap, release notes, and support documentation, or use it as a neat way to showcase feedback and reviews (like below).
Organise release notes
Make your release notes easier to digest by combining the Advanced Cards and Tabs macro. Separate tabs to categorise new features, known issues, security updates, or other bug fixes, and embed cards to create a high-level overview of key points in each section.
You could even separate out the changelog by platform, so having separate tabs for Web, iOS, or Android. All of this will help to keep your page clean while providing all the necessary details.
You could even separate out the changelog by platform, so having separate tabs for Web, iOS, or Android. All of this will help to keep your page clean while providing all the necessary details.
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 Advanced Cards macro, you can display multiple links in one central place - and even show a preview of the page you’re linking to.
Make your knowledge base more engaging
A Confluence knowledge base is a central information hub that helps users find answers quickly. Good structuring and navigation are key to helping people digest information at a glance. The Advanced Cards macro is a great way to draw attention to the most important content on a page and highlight text in Confluence.
And there you have it! With the Advanced Cards macro, you can transform text-heavy pages into engaging, easy-to-navigate resources that your team will love to use.
Discover the Advanced Cards macro in Confluence Cloud
Get a free month of Mosaic and create beautiful, engaging pages today.
Written by