You can upload Microsoft Teams apps without having to publish to your organization or the Microsoft Teams Store in the following scenarios:
You want to test and debug an app locally yourself or with other developers.
You built an app for yourself to automate a workflow.
You built an app for a small set of users, such as, your work group.
Important
Custom app upload is possible only in Government Community Cloud (GCC) and isn't possible in GCC High, Department of Defense (DoD), and Teams operated by 21Vianet.
App installation is supported only on Teams desktop client.
We recommend you to avoid multiple uploads of your message extension app to Teams, as it results in multiple instances of the message extension.
Users can't chat with bots that aren't connected to a Microsoft Teams app such as Azure bots created through the Bot Framework or Power Virtual Agents. We recommend you to create a new Teams app connected to the Azure Bot using the Developer Portal, publish it to Teams, and allow users to install the app using the app permission policies.
If you want to test the app, you can assign users an app setup policy that allows uploading custom apps and chat with the Azure bot through a direct link to a chat.
Alternatively, you can either search and select the required scope or select a channel or chat from the list, and move through the dialog to select Go.
Troubleshoot
If your app fails to upload or encounters any issues to upload, check the following options:
Ensure your app manifest matches with the latest schema.
Manage your apps
Manage your apps allows users to have a dedicated place to manage, update and remove their apps, permissions, and subscriptions on the Teams client. The users can install the apps from Manage your apps.
Access your app
To access apps through Manage your apps, follow the steps:
Go to Apps and select Manage your apps in Teams to view the installed apps across all your channels or for personal use in a list format.
Select the app dropdown to view the list of scopes where the app is installed.
Select the scope of app to go to the app in the channel or personal view. The list of scopes consists of personal scope and teams scope only. Apps installed in group chat scope aren't displayed in this view.
You don't have to upload your custom app again if you make code changes (these are reflected in Teams in real-time). However, you must reinstall if you change any app configurations. For more information, see Role of an admin in upgrading Teams apps.
When a Teams app receives an update, the user must consent to update the app in any one context, and the app is automatically updated in all the related contexts (chats, channels, and meetings) where the app is installed. The user can update the app from any context.
If an update is available for your app, follow these steps to update your app from the Teams Store:
Go to Microsoft Teams.
Select Apps > Manage your apps.
Under the Apps tab, check for the Update option next to the app.
Select Update.
Select Update now.
The app is automatically updated in all the related contexts (chats, channels, and meetings) where the app is installed.
Remove your app
To remove app from Teams, follow the steps:
Find the app in Manage your apps.
Select
at the scope of the installed app.
Select Remove to remove your app.
Note
You can't remove personal bot activity entirely. If you remove the app and add it again, new communication with the bot appends to the previous conversation with it.
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Platform Docs feedback
Platform Docs is an open source project. Select a link to provide feedback:
Demonstrate skills to plan, deploy, configure, and manage Microsoft Teams to focus on efficient and effective collaboration and communication in a Microsoft 365 environment.