Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

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.28

May 2026

https://developer.microsoft.com/json-schemas/teams/v1.28/MicrosoftTeams.schema.json

Expanded the range of icons array for extension tab groups (extensionRibbonsCustomTabGroupsItem object) to minItems = 3 (from 1) and maxItems = 8 (from 3).
Enable Office Add-ins to show or hide ribbon buttons, controls, and groups in custom or contextual tabs across Word, Excel, and PowerPoint (Win32, Mac, Web) using the new property visible for dynamic UI and less clutter.
The agentSkills property allows developers to package AI agent skills as elements.

All generally available versions

What's new in manifest version 1.26

April 2026

https://developer.microsoft.com/json-schemas/teams/v1.26/MicrosoftTeams.schema.json

Added optional composeExtensions.authorization.oAuthConfiguration object to implement Open Authorization (OAuth) 2.0 support for API-based message extensions.
Added features descriptions list to showcase agent and app features to a profile card that appears when the user hovers over the app icon.
KeyTips let developers set custom shortcut keys in Office, giving users more efficient ways to work in Word, Excel, and PowerPoint.

All generally available versions

What's new in manifest version 1.25

January 2026

https://developer.microsoft.com/json-schemas/teams/v1.25/MicrosoftTeams.schema.json

New agenticUserTemplates node to reference an Agent 365 blueprint, enabling the instantiation of an AI agent with its own Microsoft Entra Agent ID within your organization.
Added supportsChannelFeatures to opt in your app to next level channel features, including shared and private channels.
Enhanced support for Excel custom functions, including customFunctions.enum to provide autocomplete options for custom functions and additional function properties and datatypes from CustomFunctionsRuntime 1.5.

All generally available versions

What's new in manifest version 1.24

October 2025

https://developer.microsoft.com/json-schemas/teams/v1.24/MicrosoftTeams.schema.json

Added executeDataFunction action type to enable Copilot agents to invoke Office Add-ins functions and serve as natural language interfaces to add-ins. The overall functionality of combining Copilot agents with Office Add-ins remains in preview.
Introduced windowsExtensions mechanism to specify which COM- and VSTO-based add-ins should be disabled with the equivalent JavaScript add-in is installed. For more details, see Option to disable the Windows-only add-in instead.
Added keyboardShortcuts to support backwards compatibility of Office Add-ins with keyboard shortcuts and their localized strings (if applicable).
Increased bot commands limit from 10 to 12 to accommodate Microsoft Copilot Studio agents, which support up to 12 starter prompts.

All generally available versions

What's new in Version 1.23

July 2025

https://developer.microsoft.com/json-schemas/teams/v1.23/MicrosoftTeams.schema.json

Updated extensionRibbonsCustomTabGroupsItem to include the overriddenByRibbonApi property, which hides groups in apps that support custom contextual tabs via the Office.ribbon.requestCreateControls API. Removed redundant node extensionCommonCustomControlMenu.
Added bot registrationInfo field to accommodate system-generated metadata for agents built with Microsoft Copilot Studio and other tools.
Improved description for spamReportingOptions

All generally available versions

What's new in Version 1.22

May 2025

https://developer.microsoft.com/json-schemas/teams/v1.22/MicrosoftTeams.schema.json

Added activityIcons and allowedIconIds properties to customize app icons in a user's activity feed. activityIcons defines the icon, while allowedIconIds specifies which icons appear for each activity type. For more information, see the Teams activity feed and custom icon guidelines.
Added the type property to the spam reporting preprocessing dialog to support either radio buttons or checkboxes for reporting options. For details, see Configure the manifest.
Added nestedAppAuthInfo property to enable prefetching of a nested app authentication token when a tab is loaded. See Nested app authentication to learn more.

All generally available versions

What's new in Version 1.21

April 2025

https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json

Developers can now specify a 32x32 color icon with a transparent background to ensure a consistent appearance when your app runs in Outlook and Microsoft 365. To learn more see,Teams app package color icon.
Introduced new copilot value for bots.scopes and defaultInstallScope. To learn more, see Build with Teams AI library.
Added backgroundLoadConfiguration object to enable tab apps to opt in to precaching for a faster initial load experience.

All generally available versions

What's new in Version 1.20

March 2025

https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.schema.json

Added elementRelationshipSet and requirementSet (for composeExtensions, bots, and staticTabs) objects so that apps can specify runtime requirements in Microsoft 365 hosts.
Added intuneInfo object for Outlook Add-ins to attest to Intune Mobile App Management (MAM) support in order to signal compliance with organizational data protection policies.
Added fixedControls object to build custom spam-reporting handling with Outlook Add-ins.

All generally available versions

What's new in Version 1.19

September 2024

https://developer.microsoft.com/json-schemas/teams/v1.19/MicrosoftTeams.schema.json

Added copilotAgents object 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

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

May 2026

Allow ISVs to submit MCP Servers directly for certification, simplifying the onboarding path using AzureKeyVault property.
The agentSkills property allows developers to package AI agent skills as elements.

URL: https://learn.microsoft.com/en-us/microsoft-365/extensibility/schema/?view=m365-app-1.28&viewFallbackFrom=m365-app-prev%3Ftoc%3D%2Fmicrosoftteams%2Fplatform%2Ftoc.json&bc=%2Fmicrosoftteams%2Fplatform%2Fbreadcrumb%2Ftoc.json&preserve-view=true