-
Notifications
You must be signed in to change notification settings - Fork 273
[All Hosts] (devx) Article to situate add-ins in M365 ecosystem #5558
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
Rick-Kirkham
wants to merge
9
commits into
main
Choose a base branch
from
expand-to-m365
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
44a09be
[All Hosts] (devx) Article to situate add-ins in M365 ecosystem
Rick-Kirkham 98e6c5f
toc
Rick-Kirkham 0e3cab9
link fixes
Rick-Kirkham ae6b09c
small fixes
Rick-Kirkham 0921cd9
add copilot to table
Rick-Kirkham 9dbf2bd
remove preview
Rick-Kirkham bde58eb
correct add-in cell
Rick-Kirkham d94c91c
Apply suggestions from code review
Rick-Kirkham bc8da7d
review changes
Rick-Kirkham File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,85 @@ | ||
| --- | ||
| title: Extend your solution to other parts of Microsoft 365 | ||
| description: Learn how an Office Add-ins can be combined with other extensions into an app for Microsoft 365 | ||
| ms.date: 01/17/2026 | ||
| ms.localizationpriority: medium | ||
| --- | ||
|
|
||
| # Extend your solution to other parts of Microsoft 365 | ||
|
|
||
| An Office Add-in is an App for Microsoft 365, just as a custom Teams app and a custom Copilot agent are. This enables you to combine an add-in with one or more of these other types of Microsoft 365 extensions. Your combination solution has a single manifest that configures all of its parts, and a single app package—a ZIP file—that is the unit of sideloading and of publishing to Microsoft Marketplace or the Microsoft 365 admin center. | ||
|
|
||
| > [!TIP] | ||
| > You can't include a [SharePoint Framework app](/sharepoint/dev/spfx/sharepoint-framework-overview) in the Microsoft extension's app package, but you can bundle your Microsoft 365 extension with one or more SharePoint Framework apps into a single Software as a Service (SaaS) offering. The SaaS is installed and managed as a unit using the integrated apps portal in the admin center. For more information, see [SaaS linked apps](/microsoft-365/admin/manage/saas-linked-apps) and [Integrated Apps portal](/microsoft-365/admin/manage/test-and-deploy-microsoft-365-apps). | ||
|
|
||
| Use this packaging system to combine closely related functionality and experiences into a single app for Microsoft 365. Some possible scenarios include: | ||
|
|
||
| - Make a page experience available in both your add-in task pane and in a custom personal tab in one or more of the Microsoft 365 applications with an **App bar**: Teams, Outlook, and the Microsoft 365 Copilot application. | ||
| - Create a Copilot agent that gets Microsoft Graph data and is available in Excel and Teams. | ||
| - Include similar handlers for similar events, such as a user being added to a Teams conversation and a recipient being added to an Outlook message. | ||
| - Record in a database discrete user actions in an Office application, and view the accumulated data in a custom tab that is opened from the **App bar** in Teams, Outlook, or Microsoft 365 Copilot. | ||
|
|
||
| The following sections introduce some of the Microsoft 365 development features that cross the boundaries between Office, Teams, and Copilot. For a matrix of support on various platforms, see [Platform support](#platform-support). | ||
|
|
||
| ## Personal tabs | ||
|
|
||
| Reach your users where they are, right in the context of their work by extending your web app as a [personal tab](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab) application that also runs in Outlook, Teams, and the Microsoft 365 Copilot application. | ||
|
|
||
| :::image type="content" source="../images/outlook-office-teams-personal-tab.png" alt-text="The screenshot is an example that shows Personal tab running in Outlook, Microsoft 365, and Teams."::: | ||
|
|
||
| The following images show the personal tab running on Microsoft 365 for [iOS](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#microsoft-365-for-ios) and [Android app](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#microsoft-365-for-android-app). (It will also run in Outlook for [iOS](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#outlook-app-for-ios) and [Android app](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#outlook-for-android-app).) | ||
|
|
||
| # [Android](#tab/Android) | ||
|
|
||
| :::image type="content" source="../images/office-mobile-personal-tab.png" alt-text="The screenshot is an example that shows personal tab running in Microsoft 365 on Android app."::: | ||
|
|
||
| # [iOS](#tab/iOS) | ||
|
|
||
| :::image type="content" source="../images/m365-mobile-personal-tab.png" alt-text="The screenshot is an example that shows personal tab running in Microsoft 365 on iOS."::: | ||
|
|
||
| --- | ||
|
|
||
| > [!TIP] | ||
| > Personal tabs can be built and hosted with [SharePoint Framework](/microsoftteams/platform/m365-apps/extend-m365-teams-personal-tab#sharepoint-framework-spfx-apps) (SPFx) version 1.16 and later as an alternative to hosting them on a web server or web service. See [Add Teams tab to SharePoint](/microsoftteams/platform/tabs/how-to/tabs-in-sharepoint) and [Build Microsoft Teams tab using SharePoint Framework - Tutorial](/sharepoint/dev/spfx/web-parts/get-started/using-web-part-as-ms-teams-tab). Although these articles use the term "Teams tab" they apply also to personal tabs in Outlook and Microsoft 365 Copilot. | ||
|
|
||
| ## Message extensions and link unfurling | ||
|
|
||
| Message extensions enable users to interact with your web service using buttons and forms. Users can search or initiate actions in an external system from chat messages in Teams and email messages in Outlook. | ||
|
|
||
| :::image type="content" source="../images/outlook-teams-messaging-ext.png" alt-text="The screenshot is an example that shows Message extension running in Outlook and Teams."::: | ||
|
|
||
| Link unfurling works in both Outlook messages and Teams chat messages. You can also unfurl links with cards that launch Stageview. | ||
|
|
||
| :::image type="content" source="../images/outlook-teams-link-unfurling.png" alt-text="The screenshot is an example that shows Link unfurling running in Outlook and Teams."::: | ||
|
|
||
| For more information, see [Build message extensions](/microsoftteams/platform/messaging-extensions/what-are-messaging-extensions) and [Teams message extensions](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension). See also the guidance in [Scenarios for creating an Outlook add-in and a message extension](/microsoftteams/platform/m365-apps/me-or-outlook-add-in) to learn when to use a Outlook add-in and when to use a message extension in Outlook. | ||
|
|
||
| ## Meeting apps | ||
|
|
||
| Meeting apps are essentially [personal tabs](#personal-tabs) that are designed to foster collaboration before, during, and after meetings. You can configure and add meeting apps to the Teams meetings scheduled from Outlook and also run meeting apps within the Outlook calendar. | ||
|
|
||
| :::image type="content" source="../images/outlook-teams-meeting-app.png" alt-text="Screenshot of a sample meeting app running in both Teams and Outlook"::: | ||
|
|
||
| For more information, see [Apps for meetings and calls](/microsoftteams/platform/apps-in-teams-meetings/teams-apps-in-meetings) and [Extend a meeting app to Outlook](/microsoftteams/platform/m365-apps/extend-m365-meeting-app). | ||
|
|
||
| ## Platform support | ||
|
|
||
| The following table shows platforms support the various types of Apps for Microsoft 365. | ||
|
|
||
| | Teams app features| Teams support |Outlook support |Microsoft 365 Copilot application support |Word, Excel, PowerPoint support| Notes | | ||
| |--|--|--|--|--|--|--| | ||
| | [**Tabs-personal scope**](/microsoftteams/platform/tabs/how-to/create-personal-tab) |Web, Desktop, Mobile | Web, Desktop, Mobile (Android, iOS) | Web, Desktop, Mobile (Android, iOS)|-|Channel and group scopes aren't supported for Microsoft 365. For more information, see [Teams JavaScript client library](/microsoftteams/platform/tabs/how-to/using-teams-client-sdk#microsoft-365-support-running-teams-apps-in-office-and-outlook). | ||
| | [**Meeting apps**](/microsoftteams/platform/m365-apps/extend-m365-meeting-app)|Web, Desktop, Mobile|Desktop|-|-|Meeting Stageview isn't supported in Outlook. See [Extend a meeting app to Outlook](/microsoftteams/platform/m365-apps/extend-m365-meeting-app).| | ||
| | [**Message extensions-search-based**](/microsoftteams/platform/messaging-extensions/how-to/search-commands/define-search-command)| Web, Desktop, Mobile| Web, Desktop | - |-|For limitations and troubleshooting, see [Limitations](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension#limitations). | | ||
| | [**Action-based message extensions**](/microsoftteams/platform/messaging-extensions/how-to/action-commands/define-action-command)| Web, Desktop, Mobile| Web | - |-| Viewable/actionable (not composable) in Teams/Outlook mobile preview (iOS, Android). For limitations and troubleshooting, see [Limitations](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension#limitations). | | ||
| | [**Link unfurling (including Stageview)**](/microsoftteams/platform/tabs/tabs-link-unfurling) | Web, Desktop | Web, Desktop | - | -|See notes on [link unfurling](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension) and [Stageview](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension)| | ||
| | [**Adaptive Card Loop components**](/microsoftteams/platform/m365-apps/design-loop-components)|Web, Desktop |Web, Desktop (only for [new Outlook](https://support.microsoft.com/office/getting-started-with-the-new-outlook-for-windows-656bb8d9-5a60-49b2-a98b-ba7822bc7627)) |-|-| Viewable (not composable) in Teams/Outlook mobile preview (iOS, Android). See [Adaptive Card-based Loop components](/microsoftteams/platform/m365-apps/cards-loop-component).| | ||
| | [**Stageview**](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension)|Web, Desktop, Mobile|Web (preview), Desktop (preview)|-|-| Viewable/actionable (not composable) in Outlook mobile preview (iOS, Android). See [Message extensions](/microsoftteams/platform/m365-apps/extend-m365-teams-message-extension).| | ||
| | [**Office Add-ins**](../overview/office-add-ins.md) | - | Web, Desktop | - | Web, Desktop | See [office Add-ins platform overview](../overview/office-add-ins.md).| | ||
| | [**Copilot agents**](/microsoft-365-copilot/extensibility/ecosystem) | Web, Desktop | - | Web, Desktop | Web, Desktop | See [Declarative agents for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/overview-declarative-agent) | | ||
|
|
||
| ## See also | ||
|
|
||
| - [Office Add-ins developer documentation](../overview/office-add-ins.md) | ||
| - [Microsoft 365 Copilot Agent developer documenation](/microsoft-365-copilot/extensibility/ecosystem) | ||
| - [Teams developer documentation](/microsoftteams/platform/overview) |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.