Updates from: 06/08/2021 03:12:05
Service Microsoft Docs article Related commit history on GitHub Change details
platform Enable App Customization https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/concepts/design/enable-app-customization.md
Title: Enable admins to customize your app
+ Title: Enable your app to be customized
description: Understand how Teams admins can customize your app for their org. localization_priority: Normal
-# Enable orgs to customize your Microsoft Teams app
+# Enable your Microsoft Teams app to be customized
You can allow orgs (specifically Teams admins) to customize some aspects of your Microsoft Teams app. Some possible examples include:
platform Manifest Schema Dev Preview https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/resources/schema/manifest-schema-dev-preview.md
For more information on the features available see: [Features in the Public Deve
"smallImageUrl", "largeImageUrl", "accentColor",
- "websiteUrl",
+ "developerUrl",
"privacyUrl", "termsOfUseUrl" ],
Specify your AAD App ID and Graph information to help users seamlessly sign into
**Optional** - array
-The `configurableProperties` block defines the app properties that Teams admin can customize. For more information, see [customize apps in Microsoft Teams](/MicrosoftTeams/customize-apps).
+The `configurableProperties` block defines the app properties that Teams admins can customize. For more information, see [enable app customization](~/concepts/design/enable-app-customization.md).
> [!NOTE] > A minimum of one property must be defined. You can define a maximum of nine properties in this block.
-> As a best practice, you must provide customization guidelines for app users and customers to follow when customizing your app.
You can define any of the following properties:
-* `name`: Allows admin to change the app's display name.
-* `shortDescription`: Allows admin to change the app's short description.
-* `longDescription`: Allows admin to change the app's detailed description.
-* `smallImageUrl`: It is the `outline` property in the `icons` block of the manifest.
-* `largeImageUrl`: It is the `color` property in the `icons` block of the manifest.
-* `accentColor`: It is the color to use in conjunction with and as a background for your outline icons.
-* `websiteUrl`: It is the https:// URL to the developer's website.
-* `privacyUrl`: It is the https:// URL to the developer's privacy policy.
-* `termsOfUseUrl`: It is the https:// URL to the developer's terms of use.
+
+* `name`: The app's display name.
+* `shortDescription`: The app's short description.
+* `longDescription`: The app's detailed description.
+* `smallImageUrl`: The app's outline icon.
+* `largeImageUrl`: The app's color icon.
+* `accentColor`: The color to use in conjunction with and as a background for your outline icons.
+* `developerUrl`: The HTTPS URL of the developer's website.
+* `privacyUrl`: The HTTPS URL of the developer's privacy policy.
+* `termsOfUseUrl`: The HTTPS URL of the developer's terms of use.
## defaultInstallScope
When a group install scope is selected, it will define the default capability wh
|`team`|string|||When the install scope selected is `team`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.| |`groupchat`|string|||When the install scope selected is `groupchat`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.| |`meetings`|string|||When the install scope selected is `meetings`, this field specifies the default capability available. Options: `tab`, `bot`, or `connector`.|-
platform Manifest Schema https://github.com/MicrosoftDocs/msteams-docs/commits/master/msteams-platform/resources/schema/manifest-schema.md
The following schema sample shows all extensibility options:
"smallImageUrl", "largeImageUrl", "accentColor",
- "websiteUrl",
+ "developerUrl",
"privacyUrl", "termsOfUseUrl" ]
When a group install scope is selected, it will define the default capability wh
**Optional** - array
-The `configurableProperties` block defines the app properties that Teams admin can customize. For more information, see [customize apps in Microsoft Teams](/MicrosoftTeams/customize-apps).
+The `configurableProperties` block defines the app properties that Teams admins can customize. For more information, see [enable app customization](~/concepts/design/enable-app-customization.md).
> [!NOTE] > A minimum of one property must be defined. You can define a maximum of nine properties in this block.
-> As a best practice, you must provide customization guidelines for app users and customers to follow when customizing your app.
You can define any of the following properties:
-* `name`: Allows admin to change the app's display name.
-* `shortDescription`: Allows admin to change the app's short description.
-* `longDescription`: Allows admin to change the app's detailed description.
-* `smallImageUrl`: It is the `outline` property in the `icons` block of the manifest.
-* `largeImageUrl`: It is the `color` property in the `icons` block of the manifest.
-* `accentColor`: It is the color to use in conjunction with and as a background for your outline icons.
-* `websiteUrl`: It is the https:// URL to the developer's website.
-* `privacyUrl`: It is the https:// URL to the developer's privacy policy.
-* `termsOfUseUrl`: It is the https:// URL to the developer's terms of use.
-
+* `name`: The app's display name.
+* `shortDescription`: The app's short description.
+* `longDescription`: The app's detailed description.
+* `smallImageUrl`: The app's outline icon.
+* `largeImageUrl`: The app's color icon.
+* `accentColor`: The color to use in conjunction with and as a background for your outline icons.
+* `developerUrl`: The HTTPS URL of the developer's website.
+* `privacyUrl`: The HTTPS URL of the developer's privacy policy.
+* `termsOfUseUrl`: The HTTPS URL of the developer's terms of use.