We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

Display beautiful, dynamic content on your page with Cards

This feature is available with  Confluence Cloud Premium and Enterprise.

Cards allow you to organize and display interactive content on your page. They’re ideal for for highlighting key information in a visually appealing way, or presenting a collection of related items.

Cards can transform Confluence, Jira, and Atlas links or external URLs into beautiful, clickable page elements. You can add as many cards as you’d like to a page, and customize them in a variety of ways.

You can also create your own filters that will dynamically populate cards from a set of predefined sources.

Cards macro displayed on a page

To add cards to your page:

  1. Select (+) from the toolbar, then find Cards. Or, type /cards from the body of your page.

  2. Upon selection, a group of three cards will appear on your page.

  3. Select the cards element and choose a display option from the floating menu:

    • Back to center: The cards element is the width of your text.

    • Go wide: The card element is wide than the default text width, but doesn’t fill the screen.

    • Go full width: The card element fills the screen width and will respond to changes in your browser window size.

During customization, you can create or delete as many cards as you’d like.


To customize and configure your cards: 

  1. Select the frame around the cards that you want to configure, then select the Edit () icon to open the configuration panel.

  2. Choose Manual or Dynamic card sets.

    • Manual cards let you choose specific links, text, and images.

    • With Dynamic cards, you set up filter that will automatically populate and update the card set.

  3. Customize your cards using the configuration options available. Cards can be generated from Confluence content or Jira work items, for example, or external URLs.

Be aware: Content displayed on your cards that comes directly from the links you’ve selected could be visible to anyone with access to your page, even if they don’t have access to the link itself.

Manual card configuration

Choose individual links and customize the look-and-feel.

Feature-level options

Option

Default

Description

Size

Medium

Choose from small, medium, or large sized cards.

Display as

Row

Display your set of cards in one long scrolling row or as a stack that wraps to new lines

Alignment

Center

Set your stacked cards to center, left, or right within the element

Alignment is not available when Display as is set to Row.

Show last update

Off

Adds a notation of when a Confluence, Jira, or Atlas link was last updated

Show owner

On

Shows an avatar of the owner for Confluence, Jira, or Atlas links

Card-level options

Option

Description

Link

Display content on your card directly sourced from Confluence, Jira, Atlas, or external URLs.

Be aware: Content displayed on your cards that comes directly from the links you’ve selected will be visible to anyone with access to your page, even if they don’t have access to the link itself.

Title

We highly recommend adding a header title to your card. This defaults to the title of the link.

Description

Add a caption or other text below the title of your card.

For Confluence links, you can ask Atlassian Intelligence to suggest description that you will be able to edit.

Image

You can add an image to your card by browsing and selecting from Unsplash, selecting the image we’ve sourced from any link added, or uploading an image directly. We recommend images that are 700 px or wider.

Dynamic card configuration

Design a set of filters that will automatically create cards that automatically stay updated. Dynamic cards are made up of Confluence docs that match the criteria you select.

When you choose dynamic cards, the card set won’t be populated until you build your filters. Select Build dynamic cards to begin.

the Build dynamic cards filter configuration screen

Filter options

Choose how you filter content from Confluence. Where you can select more than one option, a link must only match one of them to be included. For example, if you add labels such as benefits and team-news, any content with at least one of those labels will be shown.

Option

Description

Last updated

Make sure you’re surfacing the latest info by limiting cards to links updated in a specific timeframe.

Type

Select All or limit your content to either pages or blog posts.

Contributor

Use the search field to find specific authors or editors.

Owner

Limit your cards to content owned by specific people.

Space

Choose one or more spaces to source your content.

Content under

Select a parent page to choose child content of a specific parent.

Verified

Filter only content that has been marked verified by the owner or an admin.

Label

Add labels to include only content that has one or more of your selected labels.

Sort by…

By default, your card set will be sorted by newest updates, but you can change it to oldest updates or sorted by original creation date.

Feature-level options

Once you build your filter, you can change the look-and-feel of the cards.

Option

Default

Description

Size

Medium

Choose from small, medium, or large sized cards.

Display as

Row

Display your set of cards in one long scrolling row or as a stack that wraps to new lines.

Alignment

Center

Set your stacked cards to center, left, or right within the element.

Alignment is not available when Display as is set to Row.

Show last update

Off

Adds a notation of when a Confluence, Jira, or Atlas link was last updated.

Show owner

On

Shows an avatar of the owner for Confluence, Jira, or Atlas links.

Number of cards

3

Use the slider to choose how many cards you want to show.

 



Still need help?

The Atlassian Community is here for you.