Showcase

Owned by Elizabeth Tai (Unlicensed)
Last updated: Sept 21, 2023 by Smita Nair
2 min read

Description

Puts your page items under a spotlight with paper-like cards. You can use it to create categories, pin-ups, menus, and highlights.

Starting from version 5.11.2, this macro is available in mobile view (Server only).

A number of parameters have different names in the Cloud version, but they work the same way as the Server version parameters, Server parameter names will be automatically converted to Cloud parameter names during migration. For more details on the affected parameters, refer to the table below.

Parameters

Name

Required

Available In

Migratable to Cloud?

Default Value

Description

Showcase style

 Yes

Cloud

Yes

Featured image

Select a showcase type to style the showcase cards. Choose from three options:

  • Featured image - Specify a valid and non-expiring URL.

  • Emoji icon - Select from pre-existing emojis to use as Showcase image.

  • Simple - None of the above.

Title (Server)

 Optional

Server, Data Center

Yes



Title for the showcase.

Title (Cloud)

 Yes

Cloud

Yes



Title for the showcase. For the Cloud version, the title is required.

Description

 Optional

Server, Data Center, Cloud

Yes



Description for the showcase.

Image URL

 Optional

Server, Data Center, Cloud

Yes



The URL for the showcase image. For the Cloud version, refer to the Image parameter below.

You will need to enter a valid URL. Showcase will now perform stricter URL format validations for improved security.

If image(URL) used becomes invalid, review:



TIP

If you want to use an image already attached to the page, refer to this KB page for a workaround:



Image

 Optional

Cloud

Yes



Enter a URL for an image or choose an emoji. This is the Cloud version of the Image URL parameter used in the Server and Data Center version. 

Showcase card link

 Optional

Cloud

Yes



Enter a URL or Confluence content for the destination of the button after it is clicked. This is the Cloud version of the Button Link parameter used in the Server and Data Center version. 

Button Link

 Optional

Server, Data Center

Yes



Link for the action button. For the Cloud version, refer to the Showcase card link parameter.

Button Text

 Optional

Server, Data Center, Cloud

Yes



Text for the action button.

Badge

 Optional

Cloud

Yes



Set a status badge for the Showcase. After selecting this, you may also choose from one of 6 colors for the badge.

Tutorial Examples