Enable customization for your Microsoft Teams app

You can allow customers to customize some aspects of your Microsoft Teams app in the Teams admin center. This feature is supported only for apps published to the Microsoft Teams Store. Uploaded apps and custom apps (apps published within an org) can't be customized.

Some possible uses of this feature are:

  • Changing the app's accent color to match an org's brand.
  • Updating the app name from Contoso to Contoso Agent, which is the name users in the org can see. (Note: Users adding a connector to a chat or a channel can still see the original app name, Contoso.)
  • Changing the description to include language and guidance that is better understood by your organization's end-users.
  • Changing logo and logo outline to inspire confidence to the end-users to use the app since it seems provided by their organization.

You can enable the feature by defining the app properties that your customers can customize in the configurableProperties section in the app manifest (previously called Teams app manifest), starting with version 1.11. You can use Developer Portal for Teams to edit the app manifest of your app.


You can't test this feature during development. App customization isn't supported when uploading or publishing to an org's app catalog.

User considerations

Provide guidelines for customers (specifically Teams admins) who want to customize your app. For more information, see customize apps in Teams.

See also

Customize apps in the Teams admin center