Microsoft Adaptive Cards

UI that adapts
to every platform

Write your card once in JSON. It renders natively across Teams, Outlook, Cortana, and more — inheriting each platform's look and feel automatically.

10+
Host Platforms
1
JSON Schema
v1.6
Latest Version
Possibilities
Design cards in real time

Edit the JSON on the left and see your Adaptive Card render live on the right. Switch between templates to explore different layouts.

JSON Payload
Preview — Teams Light
One schema.
Everywhere it matters.

Build once. Ship to every Microsoft surface — and beyond — without touching platform-specific code.

🎨
Platform Native

Cards inherit the host app's visual language automatically. No custom theming code required — Teams cards look like Teams, Outlook cards look like Outlook.

🔒
Safe by Design

Content is delivered as declarative JSON — no raw markup or scripting. Host apps control rendering and interactivity, eliminating injection risks.

Rich Interactivity

Input controls, action buttons, submit handlers, and deep links — all expressed declaratively without writing event handlers or platform-specific logic.

🔗
Templating Engine

Separate layout from data with the Adaptive Cards Template Language. Bind dynamic data at runtime using the ${expression} syntax.

🛠️
Designer SDK

Embed the full card designer directly in your own application using the JavaScript SDK. Give users a no-code card authoring experience.

🌐
Open Standard

The schema is fully open, versioned, and public. Third-party platforms can implement Adaptive Cards rendering — the ecosystem grows beyond Microsoft.

Explore card elements

Every Adaptive Card element, its properties, and how to use them.

TextBlock element
Image element
ColumnSet container
FactSet element
Action.OpenUrl action
Action.Submit action
Input.Text input
Input.ChoiceSet input
Cards in the wild

See how Adaptive Cards power real workflows across Microsoft's suite of applications.

💬
Teams Bot Notifications
Microsoft Teams
🚀 Deployment Complete
production-api v2.4.1 deployed successfully to Azure East US at 14:32 UTC.
📧
Actionable Email
Outlook
Expense Report: Nairobi Summit
Amount$1,240.00
CategoryTravel
🤖
Copilot Responses
Microsoft 365 Copilot
Meeting Summary
Q3 planning call · 45 min · 6 attendees
Action Items: Finalize roadmap by Friday. Sarah to share design specs. Review budget allocation.
🪟
Windows Widgets
Windows 11
Tasks Today
3 remaining
Review pull request #412
Update onboarding docs
~~Send weekly report~~
Microsoft Teams
Outlook
Windows 11 Widgets
Viva Connections
Microsoft 365 Copilot
Azure Bot Framework
Power Automate
WebChat
Your first Adaptive Card

Every card is a JSON object. Start with the required fields and build up from there.

adaptive-card.json
{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Hello, Adaptive Cards! 👋",
      "size": "Large",
      "weight": "Bolder"
    },
    {
      "type": "TextBlock",
      "text": "This card renders natively on every supported platform.",
      "wrap": true,
      "color": "Accent"
    }
  ],
  "actions": [
    {
      "type": "Action.OpenUrl",
      "title": "Learn More",
      "url": "https://adaptivecards.microsoft.com"
    }
  ]
}
cards.ms — Microsoft Adaptive Cards Platform
Schema v1.6 · Open Standard · © Microsoft