--- title: Configure the Windows Taskbar Pinned Apps with Policy Settings description: Learn how to configure the applications pinned to the Windows taskbar. ms.topic: how-to ms.date: 11/07/2024 appliesto: zone_pivot_groups: windows-versions-11-10 --- # Configure the applications pinned to the taskbar The configuration of the applications pinned to the taskbar is done with the use of an XML file. This article describes how to create and deploy the XML configuration file. > [!NOTE] > If you are looking for OEM information, see the article [Customize the Taskbar](/windows-hardware/customize/desktop/customize-the-windows-11-taskbar). To learn about all the policy settings to customize the taskbar layout and configure the taskbar behaviors, see [Taskbar policy settings](policy-settings.md). ## Before you begin Here are some considerations before you start configuring the taskbar pinned applications: - There's no limit to the number of apps that you can pin. - In the XML file, add apps using the Application User Model ID (AUMID), the Desktop Application ID, or the Desktop Application Link Path. - Some classic Windows applications are packaged differently than they were in previous versions of Windows, including Notepad and File Explorer. Make sure to enter the correct Application ID. To learn more, see [Find the Application User Model ID of an installed app](../store/find-aumid.md). - If you specify an app to be pinned that isn't provisioned for the user on the device, the pinned icon doesn't appear on the taskbar. - The order of applications in the XML file dictates the order of pinned apps on the taskbar, from left to right. If the OS is configured to use a right-to-left language, then the taskbar order is reversed - Applications can be pinned using the following methods: - Default Windows apps, pinned during the OS installation. For example: Microsoft Edge, File Explorer, and Store. These applications are pinned first (blue square). - Pinned manually by the user. These applications are usually pinned next to the default pinned apps (red circle). - Pinned via policy settings. These applications are pinned after the apps pinned manually by the user (green triangle). ::: zone pivot="windows-10" :::image type="content" source="images/pin-layout-10.png" border="false" lightbox="images/pin-layout-10.png" alt-text="Screenshot of the taskbar with Windows default pinned apps, user pinned apps, and policy-pinned apps."::: ::: zone-end ::: zone pivot="windows-11" :::image type="content" source="images/pin-layout-11.png" border="false" lightbox="images/pin-layout-11.png" alt-text="Screenshot of the taskbar with Windows default pinned apps, user pinned apps, and policy-pinned apps."::: ::: zone-end ## Configuration steps The following steps describe how to configure the taskbar pinned applications using policy settings: 1. Create the XML file. You can start with the [XML example](#taskbar-layout-example). 1. Edit the XML file to meet your requirements and save it. 1. Deploy the XML file to devices using configuration service provider (CSP), provisioning packages (PPKG), or group policy (GPO). ### Taskbar configuration and policy refresh Depending on the method you use to configure the taskbar, the configuration is reapplied at different intervals. When the taskbar configuration is reapplied, user changes are overwritten. | Configuration method | Reapplied interval | |--|--| | Configuration service provider (CSP) | Every 8 hours or based on the [ConfigRefresh](/windows/client-management/mdm/dmclient-csp#deviceproviderprovideridconfigrefresh) interval. | | Provisioning package (PPKG) | Each time the `explorer.exe` process restarts. | | Group policy (GPO) | In case of a group policy change. | > [!CAUTION] > The use of the `Import-StartLayout` PowerShell cmdlet to provision the Taskbar layout is no longer supported in Windows 11. ::: zone pivot="windows-10" >[!NOTE] >If you use GPO and your configuration only contains a taskbar layout, the default Windows tile layout will be applied and cannot be changed by users. If you use GPO and your configuration includes taskbar and a full Start layout, users can only make changes to the taskbar. If you use Group Policy and your configuration includes taskbar and a partial Start layout, users can make changes to the taskbar and to tile groups not defined in the partial Start layout. > > For more information, see [Configure the Start menu](../start/index.md). ::: zone-end ## Taskbar layout example Here you can find an example of taskbar layout that you can use as a reference: [!INCLUDE [example](includes/example.md)] ### Modify the configuration file > [!CAUTION] > When you make changes to the XML file, be aware that the XML format must adhere to an [XML schema definition (XSD)](xsd.md). You can change the apps pinned to the taskbar by modifying the `` node. 1. In the `` node, add (or remove) the apps you want pinned. You can pin Universal Windows Platform (UWP) apps and desktop apps: - ``: Select this option for UWP apps. Add the *AUMID* of the UWP app. - ``: Select this option for desktop apps. Add the *Desktop Application ID* or the *Desktop Application Link Path* of the desktop app. 1. In the `` node, the apps you add are pinned after the default apps. If you want to remove the default apps, and only show the apps you add in the XML file, then add `PinListPlacement="Replace"`: - ``: Keeps the default pinned apps. After the default apps, the apps you add are pinned. - ``: Unpins the default apps. Only the apps you add are pinned. If you want to remove some of the default pinned apps, then add `PinListPlacement="Replace"`. When you add your apps to ``, include the default apps you still want pinned. 1. In the `` node, use `region=" | "` to use different taskbar configurations based on the device locale and region. 1. Save the file. For practical examples of how to add, remove, or replace pinned apps, see the following sections: - [Add pins](#example-add-pins) - [Remove default pins](#example-remove-pins) - [Replace default pins](#example-replace-pins) - [Configure the taskbar by country or region](#example-configure-the-taskbar-by-country-or-region) #### Example: add pins The `` section appends the listed apps to the taskbar by default. The following sample keeps the default apps pinned and adds pins for Paint, Microsoft Reader, and a command prompt. [!INCLUDE [example-add-pins](includes/example-add-pins.md)] **Before and after:** ::: zone pivot="windows-11" :::image type="content" source="images/pin-add-11.png" alt-text="Screenshot of the Windows 11 taskbar, before and after adding pins." border="false" lightbox="./images/pin-add-11.png"::: ::: zone-end ::: zone pivot="windows-10" :::image type="content" source="images/pin-add-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after adding pins." border="false" lightbox="./images/pin-add-10.png"::: ::: zone-end #### Example: remove pins To remove all pins, add `PinListPlacement="Replace"` to ``. [!INCLUDE [example-remove-pins](includes/example-remove-pins.md)] **Before and after:** ::: zone pivot="windows-11" :::image type="content" source="images/pin-remove-11.png" alt-text="Screenshot of the Windows 11 taskbar, before and after removing pins." border="false" lightbox="images/pin-remove-11.png"::: ::: zone-end ::: zone pivot="windows-10" :::image type="content" source="images/pin-remove-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after removing pins." border="false" lightbox="images/pin-remove-10.png"::: ::: zone-end #### Example: replace pins To replace all default pins and add your own pins, add `PinListPlacement="Replace"` to ``. Then, add the pins that you want to `TaskbarPinList`. [!INCLUDE [example-replace-pins](includes/example-replace-pins.md)] **Before and after:** ::: zone pivot="windows-11" :::image type="content" source="images/pin-replace-11.png" alt-text="Screenshot of the Windows 11 taskbar, before and after replacing pins." border="false" lightbox="images/pin-replace-11.png"::: ::: zone-end ::: zone pivot="windows-10" :::image type="content" source="images/pin-replace-10.png" alt-text="Screenshot of the Windows 10 taskbar, before and after replacing pins." border="false" lightbox="images/pin-replace-10.png"::: ::: zone-end #### Example: configure the taskbar by country or region In the following XML example, two regions are added: `US|UK` and `DE|FR|IT`: [!INCLUDE [example](includes/example-region.md)] - If the `` node has region matching the one configured on the device, then the configuration applies. - If the `` node doesn't have a region matching the one configured on the device, then the first `` node without region applies. > [!NOTE] > [Look up country and region codes (use the ISO Short column)](/previous-versions/commerce-server/ee799297(v=cs.20)) ## Deploy the taskbar configuration [!INCLUDE [tab-intro](../../../includes/configure/tab-intro.md)] #### [:::image type="icon" source="../images/icons/intune.svg"::: **Intune/CSP**](#tab/intune) To configure devices with Microsoft Intune, [create a Settings catalog policy](/mem/intune/configuration/settings-catalog) and use one of the following settings: | Category | Setting name | Value | |--|--|--| | **Start** | Start Layout | Content of the XML file| | **Start** | Start Layout (User) | Content of the XML file| [!INCLUDE [intune-settings-catalog-2](../../../includes/configure/intune-settings-catalog-2.md)] Alternatively, you can configure devices using a [custom policy][MEM-1] with the [Start CSP][WIN-1]. Use one of the following settings: | Setting | |--| | - **OMA-URI:** `./User/Vendor/MSFT/Policy/Config/Start/`[StartLayout](/windows/client-management/mdm/policy-csp-Start#startlayout)
- **String:**
- **Value:** content of the XML file | | - **OMA-URI:** `./Device/Vendor/MSFT/Policy/Config/Start/`[StartLayout](/windows/client-management/mdm/policy-csp-Start#startlayout)
- **Data type:**
- **Value:** content of the XML file | [!INCLUDE [intune-custom-settings-2](../../../includes/configure/intune-custom-settings-2.md)] #### [:::image type="icon" source="../images/icons/provisioning-package.svg"::: **PPKG**](#tab/ppkg) [!INCLUDE [provisioning-package-1](../../../includes/configure/provisioning-package-1.md)] - **Path:** `Policies/Start/StartLayout` - **Value:** content of the XML file > [!NOTE] > The content of the file must be entered as a single line in the `Value` field. Use a text editor to remove any line breaks from the XML file, usually with a function called *join lines*. [!INCLUDE [provisioning-package-2](../../../includes/configure/provisioning-package-2.md)] #### [:::image type="icon" source="../images/icons/group-policy.svg"::: **GPO**](#tab/gpo) To configure a device with group policy, use the [Local Group Policy Editor](/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc731745(v=ws.10)). To configure multiple devices joined to Active Directory, [create or edit](/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc754740(v=ws.11)) a group policy object (GPO) and use one of the following settings: | Group policy path | Group policy setting | Value | | - | - | - | |**Computer Configuration** > **Administrative Templates** > **Start Menu and Taskbar**| Start Layout | Path to the XML file | |**User Configuration** > **Administrative Templates** > **Start Menu and Taskbar**| Start Layout | Path to the XML file | [!INCLUDE [gpo-settings-2](../../../includes/configure/gpo-settings-2.md)] The GPO applies the Start and taskbar layout at the next user sign-in. Each time the user signs in, the timestamp of the .xml file with the Start and taskbar layout is checked and if a newer version of the file is available, the settings in the latest version of the file are applied. --- ## User experience After the taskbar layout is applied, the users must sign out and sign in again to see the new layout. Unless prohibited via policy settings, users can pin more apps, change the order, and unpin apps from the taskbar. ### OS install and upgrade experience On a clean install of Windows, if you apply a taskbar layout, the following apps are pinned to the taskbar: - Any default apps you don't remove. - Apps that you specifically pin in the XML file. On a Windows OS upgrade, apps are already pinned to the taskbar. The taskbar layout applies the following logic: - If users pinned apps to the taskbar, then those pinned apps remain. New apps are pinned after the existing user-pinned apps. - If the apps are pinned during the install or by a policy (not by a user), and the apps aren't pinned in an updated layout file, then the apps are unpinned. - If a user didn't pin an app, and the same app is pinned in the updated layout file, then the app is pinned after any existing pinned apps. - New apps in updated layout file are pinned after the user's pinned apps. If you apply the taskbar configuration to a clean install or an update, users can still: - Pin more apps - Change the order of pinned apps - Unpin any app ## Next steps Learn more about the options available to configure Start menu settings using the Configuration Service Provider (CSP) and Group Policy (GPO): - [Taskbar policy settings](policy-settings.md) --- [WIN-1]: /windows/client-management/mdm/policy-csp-start [MEM-1]: /mem/intune/configuration/custom-settings-windows-10