Skip to main content
Skip table of contents

Adaptive cards

Adaptive cards display Jira information, like text and Jira fields, in messages posted by the Microsoft 365 for Jira Teams bot. The issue view cards are automatically generated when a conversation is initiated in a Microsoft Teams channel from Jira.

You have the flexibility to create various custom adaptive cards tailored to your individual use case. Once configured, you can activate the most suitable adaptive card when setting up your Microsoft Teams channel Preset.

We are working on a better set-up experience and enhanced configuration options for more adaptive cards. Stay tuned for updates.

Currently, we’re only offering the adaptive card with “Issue view” configuration.

2412-Marketplace-MTFJ20.png

Set-up

Create an adaptive card

Open your Microsoft 365 for Jira settings and go to the “adaptive cards” tab. Edit existing cards or create a new one.

image-20250320-094739.png

Define an adaptive card

Give your card a unique name. Configure the design of the issue card and simultaneously check the layout in the preview area. Toggle “render issue fields without values”* to also display fields with no value.

image-20250320-095125.png

* When issue fields lack values, like an unset due date, they still display as reminders to add necessary information, ensuring nothing is overlooked.


Preview field

Check the layout of the design configured. Click on the “show more” button to get an overview on how all Jira information will be displayed.* Create the adaptive card, when finished.

image-20250320-100913.png

* The issue preview displays your recently accessed issues. Click in the issue field to search for a specific issue to display.


Channel Presets

Once the card is created, go to the Teams channel Preset settings. Now, choose the adaptive card in the “Issue card” - section (refer to your card name here!) to be send when an issue is shared from Jira to Teams.

image-20250320-101151.png

Admin responsibilities

 

Responsibility

To Do

Option

Jira global admin

Creates Presets for their organization
(via admin settings)

Benefits

✍️ Easier card setup for admins

The enhanced user interface in the card settings allows Jira administrators to configure adaptive cards more intuitively and efficiently. With a simple drag-and-drop feature, users can easily set up their cards and review them in preview mode.

đź“Ś Streamlined information sharing

Utilizing preconfigured adaptive cards, issue information shared from Jira or from Microsoft Teams is presented in a clear and structured manner. Adaptive cards ensure that relevant issue details are included, making essential information about them readily accessible to the entire team.

🏗️ Structured for your individual use case

Adaptive Cards in Microsoft Teams enable real-time tracking for software development and incident management by displaying updates, allowing status changes, and integrating with Jira. They enhance communication, minimize context switching, and facilitate quick decisions within Teams. For incidents, they centralize internal and stakeholder comments, promoting faster resolution through structured workflows.

Roadmap 

Currently, this feature is limited to Teams channel presets, but support for other use cases, such as adaptive cards in Teams chats, is on our roadmap.

In the future, you will also have the capability to use adaptive cards within the automation feature. 

We’d love to hear your feedback. Let us know how you’d use this feature. 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.