Microsoft 365 app manifest schema reference
The app manifest for Microsoft 365 is a JSON file that describes the functionality and configuration of your app, and how it integrates with Microsoft 365 products, including Microsoft 365 Copilot, Teams, Outlook, and more.
The app manifest is part of the unified Microsoft 365 app package: a simple zip folder that includes app manifest, icons, and optional Copilot agent manifest definitions. Using a common packaging format, you can submit Microsoft 365 Copilot agents, Teams apps, SharePoint Framework apps, Graph connectors, and Office Add-ins to the Microsoft 365 and Copilot program in Microsoft Partner Center as a Store offer, or submit directly to your organization's app catalog. Microsoft 365 apps are centrally deployed and managed from the Integrated Apps portal of Microsoft 365 admin center.
What's new in manifest version 1.20
March 2025
https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.schema.json
- Added
elementRelationshipSetandrequirementSet(forcomposeExtensions,bots, andstaticTabs) objects so that apps can specify runtime requirements in Microsoft 365 hosts. - Added
intuneInfoobject for Outlook Add-ins to attest to Intune Mobile App Management (MAM) support in order to signal compliance with organizational data protection policies. - Added
fixedControlsobject to build custom spam-reporting handling with Outlook Add-ins.
All generally available versions
Version 1.19
Version 1.19
September 2024
https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json
- Added
copilotAgentsobject for publishing declarative agents for Microsoft 365 Copilot. - Added
defaultLanguageFile, a new required property for Copilot agents that support multiple languages.
Version 1.18 Not available.
Version 1.17
Version 1.17
April 2024
https://developer.microsoft.com/json-schemas/teams/v1.17/MicrosoftTeams.schema.json
- Added support for mobile specific manifest elements for Outlook extensions.
- Added
semanticDescriptionfield for Copilot for Microsoft 365. Learn more. - Added support for creating message extensions from an existing API.
- Added apps to easily show as cards on Viva Connections Dashboard.
- Added new sample prompts to guide users who install or enable a plugin for the first time.
- Added bot configurations changes.
- Deprecated
packageNameproperty. - Deprecated
callingSidePanelfrom manifest.
Version 1.16
Version 1.16
February 2023
https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json
- Added
supportsAnonymousGuestUsersinmeetingExtensionDefinition. - Added
teamandgroupChatto the scope of staticTab. - Added
privateChatTab,meetingChatTab,meetingDetailsTab,meetingSidePanel,meetingStage,teamLevelAppto the context of staticTab.
Version 1.15
Version 1.15
November 2022
https://developer.microsoft.com/json-schemas/teams/v1.15/MicrosoftTeams.schema.json
- Added
supportsAnonymizedPayloadsfeature. A Boolean that indicates whether the app's link message handler supports anonymous invoke flow.
Version 1.14
Version 1.14
July 2022
https://developer.microsoft.com/json-schemas/teams/v1.14/MicrosoftTeams.schema.json
- Added
supportedChannelTypesfeature. List of 'nonstandard' channel types that the app supports. Note: Channels of standard type are supported by default if the app supports team scope. - Added
supportsStreamingfeature. A Boolean value indicating whether this app can stream the meeting's audio video content to a Real-Time Messaging Protocol (RTMP) endpoint.
Version 1.13
Version 1.13
May 2022
https://developer.microsoft.com/json-schemas/teams/v1.13/MicrosoftTeams.schema.json
With the release of version 1.13 of the App manifest, developers can build and update their app (formerly Teams app) to run in Microsoft 365 hosts such as Outlook, Teams, and Microsoft Teams App across web, desktop, and mobile. From this version release, it eases deployment workflow and provides a streamlined way to deliver cross-platform apps to an expanded user audience via a single codebase. For more details on host application feature support, visit TeamsJS capability support across Microsoft 365.
- This schema version supports extending Teams apps to other parts of the Microsoft 365 ecosystem. More info at https://aka.ms/extendteamsapps.
What's new in Version 1.19
September 2024
https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json
- Added
copilotAgentsobject for publishing declarative agents for Microsoft 365 Copilot. - Added
defaultLanguageFile, a new required property for Copilot agents that support multiple languages.
All generally available versions
Version 1.19
Version 1.19
September 2024
https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json
- Added
copilotAgentsobject for publishing declarative agents for Microsoft 365 Copilot. - Added
defaultLanguageFile, a new required property for Copilot agents that support multiple languages.
Version 1.18 Not available.
Version 1.17
Version 1.17
April 2024
https://developer.microsoft.com/json-schemas/teams/v1.17/MicrosoftTeams.schema.json
- Added support for mobile specific manifest elements for Outlook extensions.
- Added
semanticDescriptionfield for Copilot for Microsoft 365. Learn more. - Added support for creating message extensions from an existing API.
- Added apps to easily show as cards on Viva Connections Dashboard.
- Added new sample prompts to guide users who install or enable a plugin for the first time.
- Added bot configurations changes.
- Deprecated
packageNameproperty. - Deprecated
callingSidePanelfrom manifest.
Version 1.16
Version 1.16
February 2023
https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json
- Added
supportsAnonymousGuestUsersinmeetingExtensionDefinition. - Added
teamandgroupChatto the scope of staticTab. - Added
privateChatTab,meetingChatTab,meetingDetailsTab,meetingSidePanel,meetingStage,teamLevelAppto the context of staticTab.
Version 1.15
Version 1.15
November 2022
https://developer.microsoft.com/json-schemas/teams/v1.15/MicrosoftTeams.schema.json
- Added
supportsAnonymizedPayloadsfeature. A Boolean that indicates whether the app's link message handler supports anonymous invoke flow.
Version 1.14
Version 1.14
July 2022
https://developer.microsoft.com/json-schemas/teams/v1.14/MicrosoftTeams.schema.json
- Added
supportedChannelTypesfeature. List of 'nonstandard' channel types that the app supports. Note: Channels of standard type are supported by default if the app supports team scope. - Added
supportsStreamingfeature. A Boolean value indicating whether this app can stream the meeting's audio video content to a Real-Time Messaging Protocol (RTMP) endpoint.
Version 1.13
Version 1.13
May 2022
https://developer.microsoft.com/json-schemas/teams/v1.13/MicrosoftTeams.schema.json
With the release of version 1.13 of the App manifest, developers can build and update their app (formerly Teams app) to run in Microsoft 365 hosts such as Outlook, Teams, and Microsoft Teams App across web, desktop, and mobile. From this version release, it eases deployment workflow and provides a streamlined way to deliver cross-platform apps to an expanded user audience via a single codebase. For more details on host application feature support, visit TeamsJS capability support across Microsoft 365.
- This schema version supports extending Teams apps to other parts of the Microsoft 365 ecosystem. More info at https://aka.ms/extendteamsapps.
What's new in developer preview
Commit history: https://github.com/microsoft/json-schemas/commits/live/teams/vDevPreview
https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json
November 2024
- Introduced optional
abbreviatedproperty for app display name to display abbreviated name on the app bar. - Stream bot messages to deliver the bot's response to users in real-time.
Previous preview releases
2024
October 2024
- Introduced runtime requirements in app manifest to tailor your app's behavior in Microsoft 365 hosts.
- copilotExtensions renamed to copilotAgents in developer preview app manifest.
September 2024
- Added support for nested app authentication for single-page applications embedded within the host environment.
June 2024
- Introduced preapproval of RSC permissions, allowing admins to manage RSC permissions for app installation.
May 2024
- Enhance your Copilot message extension plugin with Copilot to hand off a conversation to your custom engine copilot.
- With
developer.contactInfo, app developers can provide customer support, updates to the apps, security and compliance information, and bug fixes to their users. Learn more. - You can specify a 32x32 color icon with a transparent background to ensure a consistent appearance when your app runs in Outlook and Microsoft 365.
March 2024
- Learn to extend static tabs to channels with a customizable experience.
February 2024
- Introduced
systemDefaultreserved activity type for send activity feed notifications.
January 2024
- Actions help to integrate your app into your user's workflow by enabling easy discoverability and seamless interaction with the content. Extend your app across Microsoft 365 > Actions in Microsoft 365.
2023
November 2023
- Extend an action-based Teams message extension across Microsoft 365.
- Build a bot-based message extension and extend the message extension as plugin for Microsoft Copilot for Microsoft 365. Included in the guidelines are instructions how to create or upgrade a message extension plugin for Microsoft Copilot for Microsoft 365.
- Microsoft Adaptive Card Previewer enables you to preview Adaptive Cards created for Teams bot and message extension when you refine the designs.
October 2023
- Introduced the
extensionsproperty in public developer preview app manifest schema. - Build message extensions using API (API-based) to interact directly with third-party data, apps, and services.
August 2023
- Use Adaptive Card-based Loop components to build collaborative experiences within Teams message extensions that work across Microsoft 365.
- Use
callRecordingAPI to fetch meeting recording from all meetings.
July 2023
May 2023
- Use a deep link to open a tab app in meeting side panel in Teams mobile client.
- Assistants API allows you to create powerful AI assistants capable of performing various of tasks that are difficult to code using traditional methods.
- Extend Microsoft 365 Copilot to integrate with Microsoft Teams apps to turn your app into the most powerful productivity tool.
January 2023
- Send notifications to specific participants on a meeting stage with targeted in-meeting notification.
2022
December 2022
- Use share in meeting to share any document or third-party app to the meeting stage.
November 2022
- Enable bots to receive all conversation messages without being @mentioned in relevant contexts.
September 2022
- Use apps in Teams meetings scheduled through public channels.
August 2022
- Share apps to the Teams meeting stage in mobile.
- Use toggle incoming audio API to toggle the incoming audio state setting for the user in Teams meeting stage from mute to unmute or vice-versa.
- Use Collaboration controls to build custom collaborative experiences and integrate with Microsoft 365 services
May 2022
- Use Live Share to transform Teams apps into collaborative multi-user experiences without writing any dedicated back-end code.
2021
October 2021
- Enable bots to receive all channel messages using resource-specific consent (RSC).
June 2021
- Use resource-specific consent permissions to allow the app to access the data of a specific instance of a resource type.