Insert Handy Cards

  1. Go to the edit mode.

  2. Position the mouse pointer in the appropriate place on the page.
Option 1Option 2
  1. Start entering {Handy Cards}.
  2. From the prompted list of macro choices, select the macro.

  1. In the editor toolbar, click Insert more content  >  Other macros > Handy Status.
  2. In the Select Macro form, find the macro and insert it.

Check out our article to learn more about highlighting links in Confluence.

Create Handy Cards for child pages

When inserting the Handy Cards macro on the parent page, you can create previews for all the child pages. Handy Cards will display either the beginning of the child pages or the content from the Excerpt macros used across the child pages.

Choose child pages for Handy Cards

  1. Insert Handy Cards.
  2. Choose Create cards for Child pages.
  3. Specify additional parameters if needed (see below).
  4. Click Insert.

Specify Handy Cards content source

This parameter allows you to select the source for generating previews displayed on Handy Cards for child pages.

You can choose to display out of 2 options.

Top of the page

Handy Cards content will be generated automatically using the specified number of characters and the image from the beginning of all the child pages. 

You need to specify the following:

  • Number of characters: type the number of the characters in the output

(info) Handy Cards can display from 1 to 500 characters as a page preview. If not specified, the default number of characters will be used. It's 250 characters.

  • Image options
    • The first image or placeholder
      This option leads to the same size of all cards on the page. If any of your pages don't have an image with the image option for the cards selected, a default image placeholder will be displayed on a card for content consistency.

    • The first image or empty
      This option leads to the minimum card size possible without any blank spaces. Please note that in this case, the card size can be different if your image sizes are different.

    • Specific image on the page 
      To display a particular image from a source page on a card, you need to specify it in the Image name field.
    • No image

The Excerpt macro 

Handy Cards content will be generated automatically using the Excerpt macros inserted manually on the child pages. 

If a child page has no Excerpt macro when The Excerpt macro is selected as the content source for Handy Cards, the page preview for this page is generated automatically using the first image and 250 characters of text from it.

Tick the Show page title checkbox to add it to your cards.


(info) If you have more than one Excerpt macro on a page, Handy Cards will use any random Excerpt macro as the content source.

(info) For the correct work of Handy Cards, don't place links within the Excerpt macros.

The title of the page and the name of the Space are automatically depicted on Handy Cards created from the top of child pages. 

If you want only certain information from your child pages to be displayed on Handy Cards, you can use the Excerpt macro as the content source.

Specify columns layout

This parameter allows you to select the option of displaying cards in the page view mode.

You can choose to display:

  •  Fixed number of columns. Specify the number of columns and their width becomes responsive to the screen size.
    Additionally, you can tick the Stretch cards to fill blank spaces checkbox to automatically fill the empty spaces on the last row of cards.

  •  Fixed column width. Specify the column width and their number becomes responsive to the screen size.

Specify other parameters

You can include or exclude some additional information when creating Handy Cards.

Show timestamp

Choose whether you need to add date and time to your card.

  1. Click Show timestamp.
  2. Choose one of the options to show:
    1. none
    2. created
    3. last-modified
  3. Click Insert (on cards creation) or Save (on cards editing).

Show author

Tick a checkbox to add the author to Handy Cards.

Create Handy Cards for pages by labels

You can create previews for all the pages and/or blog posts in your instance or for a particular space or for pages by labels.

Choose pages by labels for Handy Cards

  1. Insert Handy Cards.
  2. Choose Create cards for pages by labels.
  3. Specify additional parameters if needed (see below).
  4. Click Insert.

Choose the page type

You can create Handy Cards for pages by labels of a different type. You can search for:

  1. Pages and blog posts
  2. Pages
  3. Blog posts

Limit the page space

You can create Handy Cards for pages by labels of a certain space. Use this option to make sure that all your Handy Cards are created for pages by labels from one space only. 

  1. Locate the Specify space field.
  2. Start typing the space for which you want to create Handy Cards.
  3. Choose the one from the prompted variants.

Choose labels for cards source

  1. Locate the Specify labels field.
  2. Start typing the page label you want to create Handy Cards for.
  3. Choose the one from the prompted variants.
  4. Add some more labels if needed.

Specify label logic

  1. Locate the Label logic field.
  2. Choose AND or OR logic for labels to create cards:
    1. For AND logic - all the labels specified need to be present on a page to create a card from it
    2. For OR logic - any of the labels specified need to be present on a page to create a card from it

Choose sort order

  1. Locate the Sort cards by field.
  2. Choose one of the options available
    1. Creation date
    2. Title
    3. Last modified date and time

Choose the desired number of cards

If you have a lot of cards to be created for the specified parameters, you can choose the desired number to appear on your page.

  1. Locate the Number of cards to display field.
  2. Enter the desired number of cards (1-1000). The maximum number of cards to display is 1000 cards.

When the maximum number of cards to display is not specified, the macro displays 50 cards by default.

Specify Handy Cards content source

This parameter allows you to select the source for generating previews displayed on Handy Cards for child pages.

You can choose to display out of 2 options.

Top of the page

Handy Cards content will be generated automatically using the specified number of characters and the image from the beginning of all the child pages. 

You need to specify:

  • Number of characters: type the number of the characters in the output

(info) Handy Cards can display from 1 to 500 characters as a page preview. If not specified, the default number of characters will be used. It's 250 characters.

  • Image options
    • First image
    • Specific image on the page 
      To display a particular image from a source page on a card, you need to specify it in the Image name field.
    • No image

(info) If any of your pages don't have an image with the image option for cards selected, a default image placeholder will be displayed on a card for content consistency.

The Excerpt macro 

Handy Cards content will be generated automatically using the Excerpt macros inserted manually on the child pages. 

If a child page has no Excerpt macro when The Excerpt macro is selected as the content source for Handy Cards, the page preview for this page is generated automatically using the first image and 250 characters of text from it.

Tick the Show page title checkbox to add it to your cards.


(info) If you have more than one Excerpt macro on a page, Handy Cards will use any random Excerpt macro as the content source.

(info) For the correct work of Handy Cards, don't place links within the Excerpt macros.

The title of the page and the name of the Space are automatically depicted on Handy Cards created from the top of child pages. 

If you want only certain information from your child pages to be displayed on Handy Cards, you can use the Excerpt macro as the content source.

Specify columns layout

This parameter allows you to select the option of displaying cards in the page view mode.

You can choose to display:

Fixed number of columns

 Specify the number of columns and their width becomes responsive to the screen size.

Fixed column width

Specify the column width and their number becomes responsive to the screen size.

Specify other parameters

You can use checkboxes to include or exclude some additional information when creating Handy Cards.

Select from these parameters:

  • Show author
  • Show creation date

Create Handy Cards for custom content

You can create previews for any external content on Confluence pages. 

Use custom content as a source for Handy Cards

  1. Locate the Create cards for field when inserting the Handy Cards macro.
  2. Choose the Custom content option.
  3. Specify additional parameters if needed (see below).
  4. Click Insert.

The Custom content option requires the Handy Cards Content macro within the Handy Cards macro body. The Handy Cards Content macro is a part of the Handy Macros for Confluence app. No additional installations or purchases are needed.

Specify columns layout

This parameter allows you to select the option of displaying cards in the page view mode.

You can choose to display:

Fixed number of columns

 Specify the number of columns and their width becomes responsive to the screen size.

Fixed column width

Specify the column width and their number becomes responsive to the screen size.

Specify other parameters

You can use checkboxes to include or exclude some additional information when creating Handy Cards.

Select from these parameters:

  • Show author
  • Show creation date

Use the Handy Cards Content macro

You need to add the Handy Cards Content macro inside the Handy Cards macro to specify the required custom content.

  1. After adding the Handy Cards macro as described above, place the mouse pointer in the Handy Cards body.
  2. Insert the Handy Cards Content macro.
  3. Locate the Link field.
  4. Enter the external web address for which you want your Handy Card to be created. Please, start the web address from http:// or https://.
  5. Click Save.
  6. If you want any text and/or image to appear on your Handy Cards created for custom content, place them inside the Handy Cards Content macro. Otherwise, Handy Cards will appear on your Confluence pages as clickable empty white cards.
  7. Add another Handy Cards Content macro if you want to create several Handy Cards for custom content. 
  8. Repeat steps 3-7 as many times as needed.