Publish your Microsoft Teams app
After you have built your app in Microsoft Teams App Studio, you can share it with your team by uploading it to one of your Teams channels — as long as you have the appropriate rights. You can also take the next step and share it with the world.
Teams provides an in-app gallery for users to find or discover high-quality Teams apps. To have your solution available in this gallery, you must publish your solution through AppSource.
- Register as a Microsoft app developer.
- Register in the Seller Dashboard.
- Use the Seller Dashboard to submit your Teams app package to AppSource.
- Monitor the Seller Dashboard to track validation.
Teams provides an in-app gallery for users to find or discover high-quality Teams apps. To have your solution available in this gallery, you must either:
- Publish your app through AppSource
- Publish your app through the Microsoft Teams Tenant App Catalog
Microsoft Teams Tenant App Catalog
The Microsoft Teams Tenant App Catalog contains apps unique to your tenant and is completely under your tenant's control. You can find more information in the article Publish Apps to the Microsoft Teams Tenant App Catalog. This feature can only be managed by Teams users with Microsoft Office 365 tenant admin privileges.
AppSource (formerly known as Office Store) provides a convenient location for you to distribute your Microsoft Teams app, as well as other Office 365 extensibility types such as Office add-ins and SharePoint add-ins. To include your solution in AppSource, you submit it to the Seller Dashboard. You need to create an individual or company account if you have not already done so for other Windows apps or Office extensibility types.
Register as an app developer
If you have already registered in the Microsoft Store ecosystem, either by distributing a Universal Windows App (UWA) via the Windows Store or an Office or SharePoint add-in via AppSource, you should use this account to distribute your Microsoft Teams app. Otherwise, you must first register as an app developer to create your publisher identity in the Microsoft Store ecosystem. Account registration allows you to secure your company identity and triggers validation checks by the Microsoft Store team to ensure you are who you say you are.
Account management in the Microsoft Store ecosystem relies on a Microsoft account. This identity will be the main administrator/owner of your AppSource experience. For more information, please review Opening a developer account and the Developer program FAQ.
- Create a Microsoft account specifically for your developer/AppSource account. Keep this account and password confidential, and share it only with your release team.
- Use a Microsoft account, not an Azure AD account. Although you might have leveraged the Windows Store Azure Active Directory (Azure AD) support for Windows Store account management, the AppSource Seller Dashboard requires you to use a Microsoft account, not an Azure AD account.
- If you've developed with a trial developer Office 365 account, do not use this account for your AppSource identity. Create a separate Microsoft account instead.
Register in the Seller Dashboard to submit to AppSource
A second approval process happens after you create your developer account: You need to create your identity in the AppSource Seller Dashboard. Although the content here should be similar to the details of your developer account, this extra step ensures that AppSource has all the required information and that your identity in that storefront accurately reflects your business.
If you already submitted other product types to AppSource, this additional registration may not be necessary.
To start the process, choose the Continue button under Office.
Use the Seller Dashboard to submit to AppSource
After your account is approved, you can submit your solution to the Seller Dashboard. Add an app of type "Teams App" to initiate the submission process.
You need to upload a submission package and provide the required metadata for the product listing page, including information such as app logo, description, and screenshots. Please review our Submission and Manifest Metadata Checklist for more information.
All information in the package manifest must match the metadata information you enter into the product listing.
For general information about the Seller Dashboard, see Use the Seller Dashboard to submit your solution to AppSource. For Teams-specific guidance and a detailed walk through, see Submitting your Microsoft Teams app in the Seller Dashboard.
Microsoft Teams app approval process
Teams app approval is a free service provided by AppSource that verifies that your app works as described, contains all appropriate metadata, and provides content that would be valuable to an end user.
For your Teams app to be approved:
- It must not contain inadmissible or offensive material.
- It must be stable and functional.
- Any material that you associate with your experience, such as descriptions and support documentation, must be accurate. Use correct spelling, capitalization, punctuation, and grammar in your descriptions and materials.
- It must pass all current AppSource validation policies for Teams tabs and bots. Please note that these policies are subject to change.
- For tabs, it must provide value to users outside of what is possible by simply pinning your website in Teams. This means that, at minimum, it must remove extraneous chrome and disallow navigating outside the configured context. See the Microsoft Teams Design Guidelines for more guidance.
When the validation process is complete, you will receive a message to let you know that either your Teams experience is approved or it fails one of the stated policies. You can also follow these steps to check the approval status in the Seller Dashboard:
- Sign in to the Seller Dashboard.
- On the manage tab, your submission status appears under the submission name.
- If the status is pending approval, your submission is still being verified. When it is in this state, you can't update or resubmit it.
- If the status is changes requested, your submission needs changes before approval. Select your submission; on the summary page, choose View the add-in report for details about the required changes.
- If the status is approved, your submission will be listed in the appropriate marketplaces, typically within 24 hours.
Failures are explained, with references to the specific policy violations. All failures must be addressed before resubmission. Be sure to resubmit your app using the tile on the Overview tab. Do not use the Add a new app button.
If you make changes to an approved Teams experience—specifically, changes to core functionality or the manifest—it must go through the approval process again. For all other changes to your service, such as addressing issues or adding new features, resubmission is not required.
Tips for rapid approval
- Don't use "Teams" or "Microsoft" in your app name; in all contexts, that extra clarification is superfluous.
- If your product requires an account on your service or another service, list that in the description and ensure there are links to sign up, sign in and sign out.
- If your product requires additional purchases to function properly, list that in the description.
- For your Tab configuration page, be sure to provide "About" links and proper guidance—this page is the first thing the user sees, so ensure that a new user understands what to do.
- Be sure that your bot provides appropriate responses when mentioned (@botname) in a channel and in personal conversations as needed. If your bot does not provide meaningful context within the personal or teams scope, disable that scope via the manifest. (See the
botsblock in the Microsoft Teams manifest schema reference.)
- Ensure that metadata in the manifest roughly matches metadata in the Seller Dashboard (and, for bots, in the Bot Framework registration). Note that your Seller Dashboard entry should contain a more detailed and formatted description for use in the AppSource product page.
- Check your manifest for completeness and accuracy. Then check it again.
- Be sure to include detailed testing notes and a valid, working test account with appropriate prepopulated data.
- Do not use the Add a new app button to resubmit your app. Use the tile for your app on the Overview tab instead.
- For apps incorporating private URLs a signed-in user must have a sign-out option. For apps incorporating public URLs a sign-out option is not mandatory but is a better user experience.
Add a download button to your product site
If your app is in the Microsoft Teams store, you can generate a link for your website that launches Teams and shows a consent and installation dialog for users to add the app.
The format is:
https://teams.microsoft.com/l/app/<appId> where appID is the GUID they declare in the submitted manifest.
https://teams.microsoft.com/l/app/49e6f432-d79c-49e8-94f7-89b94f3672fd is the link to install Trello.
Updating your app
When a user installs your application one of the first things they do is consent to give the app permission to access the services and information that the app needs to do its job. When you update your app, that can re-trigger this consent behavior, particularly if you have made one or more of the following changes:
- Adding a new capability to an app such as adding a bot to an tab only app
- Changing the permissions array in the manifest
Troubleshooting publishing issues
See the Issues with packaging and uploading topic for more information.