Show Card Carousel

Reference documentation for using the Teams Show Card Carousel action

Written By Support Channel

Last updated 8 months ago

Overview of the Show Card Carousel action

The Show Card Carousel action allows you to send a carousel (a scrollable row) of Adaptive Cards to a specific user in Microsoft Teams. Instead of sending one card at a time, this action lets you display multiple cards side-by-side in a single message.

Purpose

Display a carousel of Adaptive Cards based on added cards within the workflow

Parameters

1 Teams Instance, 1 User Email

Output

Carousel of Adaptive Cards

Understand the Show Card Carousel action

To successfully use the Show Card Carousel action, the following parameters must be configured. Each one plays a role in determining who sees the card carousel.

Teams Instance

Select the Microsoft Teams instance where the card will be sent

User Email

Enter the email address of the user who should receive the card. This must be a valid user within the selected Teams instance.

Create and manage Show Card Carousel actions

Add a Show Card Carousel action

Add the action

Use the following steps to add the action to a workflow.

Configure the action

Use the following steps to configure the action.

  1. Set values for the fields

    1. Teams Instance

    2. User Email

  2. Click back in the main view to hide the slide-over.

Delete a Show Card Carousel action

Use the following steps to remove the action from your workflow:

Take care when deleting an action to also remove any logic using its outputs: workflow steps may function incorrectly or break if they attempt to evaluate an output of a deleted action.

When a Show Card Carousel action is removed, any linked Update Card Carousel actions that reference it in their Card Carousel To Update field will lose that connection. As a result, the Card Carousel To Update field in those Update Card Carousel actions will be automatically cleared, since the referenced Show Card Carousel no longer exists.

Use a Show Card Carousel action

Note - Each workflow only has one card carousel at a time. If you need to show a different carousel later in the same workflow, you must first clear or complete the current carousel before displaying a new one.

A carousel displays all of its cards at once. However, each card may use a distinct card template. This means that you can mix and match different card templates inside the same carousel to fit the material you're presenting. For example, you could have three cards: one showing a status update, another a calendar event, and one a task summary.

A Show Card Carousel action can be used as a reference in other actions, like the Update Card Carousel action, once it has been introduced and set up in your workflow.