Table of contents

Publish your Microsoft Teams app to the Office Store

Richard Moe|Last Updated: 8/31/2017
2 Contributors

Important: Your Microsoft Teams app must use the latest schema and follow current packaging guidelines.

Note: Teams will soon provide 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 the Office Store.

The Office Store provides a convenient location for you to upload 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 the Office Store, 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.

Note: By developing and submitting a Microsoft Teams app, you are subject to the Bot Developer Framework Terms of Use, Privacy Policy, and Code of Conduct for bot, tab, and compose extension functionality within your app. If your app contains Office 365 Connector functionality, separate terms may also apply as part of your Connector Registration on the Connectors Developer Dashboard.

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 the Office Store, 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 Office Store experience. For more information, please review Opening a developer account and the Developer program FAQ.

Tip: We recommend you create a Microsoft account specifically for your developer/Office Store account. Keep this account and password confidential, and share it only with your release team.

Note: Although you might have leveraged the Windows Store Azure Active Directory (Azure AD) support for Windows Store account management, the Office Store Seller Dashboard requires you to use a Microsoft account, not an Azure AD account.

Important: If you've developed with a trial developer Office 365 account, do not use this account for your Office Store identity. Create a separate Microsoft account instead.

Register in the Seller Dashboard to submit to the Office Store

A second approval process happens after you create your developer account: You need to create your identity in the Office Store Seller Dashboard. Although the content here should be similar to the details of your developer account, this extra step ensures that the Office Store has all the required information and that your identity in that storefront accurately reflects your business.

If you already submitted other product types to the Office Store, this additional registration may not be necessary.

To start the process, choose the "Continue" button under Office.

Office Store Seller Dashboard entry point

Use the Seller Dashboard to submit to the Office Store

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.

Office Store Seller Dashboard add an app

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.

Important: 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 the Office Store. For Teams-specific help, see Submitting your Microsoft Teams app in the Seller Dashboard.

Microsoft Teams app approval process

Teams app approval is a free service provided by the Office Store 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 Office Store 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:

  1. Sign in to the Seller Dashboard.
  2. 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.

Note: 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.
  • 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 1:1 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 "bots" section in the Microsoft Teams manifest schema reference.)
  • Provide the requisite Terms and Privacy policy links in the manifest and the Seller Dashboard, and verify that they properly resolve to the correct documentation. For bots, you must provide this same information in the Submission section of the Bot Framework registration page.
  • 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 Office Store 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.
© 2017 Microsoft