Publish Teams apps using Teams Toolkit
After creating the app, you can distribute your app to different scope, such as individual, team, organization, or anyone. The distribution depends on multiple factors such as needs, business and technical requirements, and your goal for the app. Distribution to different scope may need different review process. In general, the bigger the scope, the more review the app needs to go through for security and compliance concerns.
Here's what you'll learn in this section:
- Publish to individual scope or sideload permission
- Publish to your organization
- Publish to Microsoft Teams store
Prerequisites
- Ensure to create your app package and validate it for errors.
- Enable custom app uploading in Teams.
- Ensure that your app is running and accessible using HTTPs.
- Ensure you have followed set of guidelines in the publish your app to the Microsoft Teams store to publish your app.
Publish to individual scope or sideload permission
You can add custom app to Teams by uploading an app package in a *.zip file directly to a team or in personal context. Adding a custom app by uploading an app package is known as sideloading. It allows you to test app while being uploaded in Teams. You can build and test app in the following scenarios:
- Test and debug an app locally.
- Build an app for yourself, such as to automate a workflow.
- Build an app for small set of users, such as, your work group.
You can build an app for internal use only and share it with your team without submitting it to the Teams app catalog in the Teams app store. For more information, see Upload your app in Teams.
To build your app to zip app package file
You need to run Provision in the cloud first before you build the app package. The following steps help you to build the app package.
- Select Zip Teams metadata package under DEPLOYMENT.
The generated app package will be located in{your project folder}/build/appPackage/appPackage.{env}.zip.
To upload app package
Perform the following steps to upload app package:
In the Teams client, select Apps > Manage your apps > upload an app.
Upload an app window appears.
Select Upload a custom app.
Now the app is sideloaded into the Teams client and you can add and view it.
Publish to your organization
When the app is ready for use in production, you can submit the app using the Teams app submission API, called from Graph API. Teams app submission API is an integrated development environment (IDE) such as Microsoft Visual Studio Code installed with Teams toolkit. The following steps help you to publish the app to your organization:
Publish from Teams Toolkit
The following steps help you to publish the app from Teams Toolkit:
You can publish your Teams app in one of the following ways:
- Select Publish to Teams under DEPLOYMENT in treeview of Teams Toolkit.
- Enter trigger Teams: Publish to Teams from command palette.
Select Install for your organization.
Now the app is successfully published to the admin portal and you see the following notice:
Now the app is available on the Manage apps of Microsoft Teams admin center, where you, and the admin can review and approve it.
Note
The app doesn't publish to your organization's app store yet. The step submits the app to the Microsoft Teams admin center where you can approve it for publishing to your organization's app store.
Approve on Admin Center
Teams toolkit for Visual Studio Code built on top of the Teams App Submission API and it allows you to automate the submission-to-approval process for custom apps on Teams.
Note
Ensure you have Teams app project in VS code. As an admin, Manage apps in the Microsoft Teams admin center is where you can view and manage all Teams apps for your organization. You can do the following activities in the admin center:
- See the org level status and properties of apps.
- Approve or upload new custom apps to your organization's app store.
- Block or allow apps at the org level.
- Add apps to Teams.
- Purchase services for third-party apps.
- View permissions requested by apps.
- Grant admin consent to apps.
- Manage org wide app settings.
The following steps help you to approve from Admin Center:
Select Go to admin portal.
Select the
icon > Teams app > Manage apps.
You can view all Teams app for your organization.
In the Pending approval widget at the top of the page lets you know when a custom app is submitted for approval. In the table, a newly submitted app automatically publishes the status of submitted and blocked apps. You can sort the publishing status column in descending order to find the app.
Select the app name to go to the app details page. On the About tab, you can view details about the app, including description, status, and app ID.
Select the status dropdown and change from Submitted to Publish.
After you publish the app, the publishing status changes to published and the status automatically changes to allowed.
For more information, see Publish to your org
Publish to Microsoft Teams store
You can distribute your app directly to the store inside Microsoft Teams and reach millions of users around the world. If your app is also featured in the store, you can instantly reach potential customers. The apps published to the Teams store also automatically list on Microsoft AppSource, which is the official marketplace for Microsoft 365 apps and solutions.
For more information, see Publish your app to the Microsoft Teams store.
See also
Feedback
Submit and view feedback for