Public developer preview for Teams

Note

Features included in preview may not be complete, and may undergo changes before becoming available in the public release. They are provided for testing and exploration purposes only. They should not be used in production applications.

Developer Preview is a public program for developers, which provides early access to unreleased features in Microsoft Teams. This allows you to explore and test upcoming features for potential inclusion in your Teams app. We also welcome feedback on any feature in developer preview. Developer preview is enabled per Microsoft Teams client, so you don't need to worry about affecting your entire organization.

Developer preview app manifest

Many features enabled in developer preview will require alterations to your app manifest JSON file. To do so, you'll need to use the developer preview manifest schema. If you use this schema, you won't be able to use Developer Portal for Teams to make these changes, nor will you be able to use it to upload your app for testing. To upload your app you'll need to select the More apps icon on the app bar, then select the Upload a custom app link. Using this method you can only upload a zipped version of your app package.

You may find it useful to use Developer Portal for Teams to create the non-developer preview portions of your app package, then export that package and manually edit the manifest.json file to add the developer preview features you wish to use. Once you've added developer preview features to the manifest.json file, you won't be able to re-import the package into Developer Portal for Teams.

Enable developer preview

Developer preview is enabled on a per-client basis, but the option to turn on developer preview is controlled at the organization level. To enable the option to turn on developer preview for an individual, you must ensure that they have the ability to upload custom apps. See setting up your tenant for additional information.

Using an app that contains developer preview features may cause clients that haven't enabled developer preview to behave unexpectedly. If you don't see an entry for developer preview, the most likely reason is your organization isn't configured for app uploading.

On a desktop or web client

To enable the public developer preview on a desktop or web client:

  1. Enable custom app uploading or sideloading for your developer tenant. For more information, see Enable custom Teams apps.
  2. Select the ellipsis (...) menu next to your user profile to display the Teams menu.
  3. Select About > Developer preview.
  4. Select Switch to Developer preview.

On a mobile client

To enable the public developer preview on a mobile client:

  1. Enable app uploading or sideloading for your developer tenant. For more information, see Enable custom Teams apps.
  2. Open the hamburger menu on the top left, then select Settings.
  3. Select About.
  4. Turn on the Developer preview toggle.

Disable developer preview

Use the same menu item under About → Developer preview, and select it to turn it off.

See also

Test and debug your Microsoft Teams app