| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| platform | Enable App Customization | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/concepts/design/enable-app-customization.md | Title: Enable app customization and block apps till admin allows + Title: Enable app customization and block apps until admin allows description: In this module, understand how Teams admins can customize your Teams app for their org and hide Teams app until admin approves. ms.localizationpriority: medium-# Enable app customization and block apps till admin allows +# Enable app customization and block apps until admin allows -Microsoft Teams lets admins customize apps to enhance the organization's store experience and to adhere to their organization's branding. This article describes how developers can allow their app to be customized by a Teams admin. For information about how admins customize an app, [Customize apps in the Teams admin center](/microsoftteams/customize-apps). +Microsoft Teams lets admins customize apps to enhance store experience and adhere to their organization's branding. An app developer can allow their app to be customized by a Teams admin. For more information about admin tasks, see +[Customize apps in the Teams admin center](/MicrosoftTeams/customize-apps). ## 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 Teams store. Sideloaded apps and apps published for an org can't be customized. +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 Teams store. Sideloaded apps and custom apps (apps published within an org) can't be customized. -Some possible examples of this feature include: +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 will see. (Note: Users adding a connector to a chat or a channel will 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 Teams app manifest](/microsoftteams/platform/resources/schema/manifest-schema#configurableproperties), starting with version 1.11. You can use [Developer Portal for Teams](https://dev.teams.microsoft.com/home) to edit the manifest of your app. Provide guidelines for customers (specifically Teams admins) who want to customi To enhance Teams app experience, you can hide an app from users by default until admin allows to unhide the app. For example, Contoso Electronics has created a help desk app for Teams. To enable appropriate functioning of the app, Contoso ElectronicsΓÇÖ wants the customers to first configure specific properties of the app. The app is hidden by default and is available to users only after the admin allows it. -To hide the app, in the app manifest file, set the `defaultBlockUntilAdminAction` property to `true`. When the property is set to `true`, in Teams admin center > **Manage apps**, **Blocked by publisher** appears in app's **Status**: +To block the app by default, in the app manifest file, set the `defaultBlockUntilAdminAction` property to `true`. When the property is set to `true`, the status of the app in Teams admin center is **Blocked by publisher** in the [Manage apps](https://admin.teams.microsoft.com/policies/manage-apps) page. :::image type="content" source="../../assets/images/manage-apps-status.png" alt-text="The screenshot is an example that shows an app blocked by publisher." lightbox="../../assets/images/manage-apps-status-expanded.png"::: |
| platform | Install Teams Toolkit | https://github.com/MicrosoftDocs/msteams-docs/commits/main/msteams-platform/toolkit/install-Teams-Toolkit.md | You can install Teams Toolkit using **Extensions** in Visual Studio Code, or ins # [Visual Studio Code](#tab/vscode) 1. Launch **Visual Studio Code**.-1. Open **Extensions** by selecting **View > Extensions** or **Ctrl+Shift+X**. You can also open extensions by selecting the extensions :::image type="icon" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/vsc-ext-icon.png" border="false"::: icon from the Visual Studio Code activity bar. +1. Select **View > Extensions** or **Ctrl+Shift+X**. The extensions marketplace pane appears. :::image type="content" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/install toolkit-1_2.png" alt-text="Screenshot shows how to install."::: + You can also open extensions by selecting the extensions :::image type="icon" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/vsc-ext-icon.png" border="false"::: icon from the Visual Studio Code activity bar. + 1. Enter **Teams Toolkit** in the search box. :::image type="content" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/install-toolkit-2_2_1.png" alt-text="Screenshot show the Toolkit."::: You can install Teams Toolkit using **Extensions** in Visual Studio Code, or ins By default, Visual Studio Code automatically keeps Teams Toolkit up-to-date. If you want to install a different release version, follow these steps: -1. Select the **Extensions** icon from the Visual Studio Code activity bar. +1. Select **Extensions** :::image type="icon" source="../assets/images/teams-toolkit-v2/extension icon.png" border="false"::: from from the Visual Studio Code activity bar. -1. Enter **Teams Toolkit** in the search box. +1. Enter **Teams Toolkit** in the search box. :::image type="content" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/TeamsToolkit-search.png" alt-text="Search for Teams Toolkit."::: -3. Select **Teams Toolkit**. +1. Select **Teams Toolkit**. -4. On the **Teams Toolkit** page, select the dropdown next to the **Uninstall** button. +1. On the Teams Toolkit page, select the dropdown next to **Uninstall**. -5. Select **Install Another Version...** from the dropdown. +1. Select **Install Another Version...** from the dropdown. :::image type="content" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/InstallAnotherVersion.png" alt-text="Select other version of VS Code."::: -6. Select the required version to install. +1. Select the required version to install. :::image type="content" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/Olderversions of VS Code.png" alt-text="Other then the latest version of VS code."::: By default, Visual Studio Code automatically keeps Teams Toolkit up-to-date. If ## Install a pre-release version -The Teams Toolkit for Visual Studio Code extension is available on GitHub. To download pre-releases, go to the [releases page on GitHub](https://github.com/OfficeDev/TeamsFx/releases) and look for extension downloads marked as :::image type="icon" source="../assets/images/teams-toolkit-v2/teams toolkit fundamentals/Pre-release icon.PNG" border="false"::: icon. +The Teams Toolkit for Visual Studio Code extension is available in a pre-release version. To install a Teams Toolkit pre-release version, follow these steps: ++1. Open **Visual Studio Code**. +1. Select **Extensions** :::image type="icon" source="../assets/images/teams-toolkit-v2/extension icon.png" border="false"::: from the Visual Studio Code activity bar. +1. Enter **Teams Toolkit** in the search box. +1. On the Teams Toolkit page, select the dropdown arrow next to **Install**. +1. Select **Install Pre-Release Version**. ::: zone-end The Teams Toolkit for Visual Studio Code extension is available on GitHub. To do > We recommend you to use Visual Studio 2022 version 17.4.1 or later for Teams Toolkit, which is the latest release to fix several known issues in previous versions of Visual Studio. 1. Download the [Visual Studio installer](https://aka.ms/VSDownload), or open it if already installed.-2. Select **Install** or select **Modify** if Visual Studio is already installed. +1. Select **Install** or select **Modify** if Visual Studio is already installed. Visual Studio installer shows all workloads, whether installed or available for installation. The Teams Toolkit for Visual Studio Code extension is available on GitHub. To do 1. On the right, select the **Microsoft Teams development tools** in the **Optional** section of the **Installation details** panel. 1. Select **Install**. -6. After the installation completes, select **Launch** to open Visual Studio. +1. After the installation completes, select **Launch** to open Visual Studio. :::image type="content" source="../assets/images/teams-toolkit-overview/visual-studio-launch_1_2.png" alt-text="Screenshot shows how to launch visual studio."::: |