14 KiB
title, description, ms.topic, ms.date, appliesto, zone_pivot_groups
| title | description | ms.topic | ms.date | appliesto | zone_pivot_groups |
|---|---|---|---|---|---|
| Configure the Windows Taskbar Pinned Apps with Policy Settings | Learn how to configure the applications pinned to the Windows taskbar. | how-to | 11/07/2024 | 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.
To learn about all the policy settings to customize the taskbar layout and configure the taskbar behaviors, see Taskbar policy settings.
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.
- 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:
- Create the XML file. You can start with the XML example.
- Edit the XML file to meet your requirements and save it.
- 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 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-StartLayoutPowerShell 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.
::: zone-end
Taskbar layout example
Here you can find an example of taskbar layout that you can use as a reference:
[!INCLUDE example]
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).
You can change the apps pinned to the taskbar by modifying the <TaskbarLayout> node.
- In the
<taskbar:TaskbarPinList>node, add (or remove) the apps you want pinned. You can pin Universal Windows Platform (UWP) apps and desktop apps:<taskbar:UWA>: Select this option for UWP apps. Add the AUMID of the UWP app.<taskbar:DesktopApp>: Select this option for desktop apps. Add the Desktop Application ID or the Desktop Application Link Path of the desktop app.
- In the
<CustomTaskbarLayoutCollection>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 addPinListPlacement="Replace":<CustomTaskbarLayoutCollection>: Keeps the default pinned apps. After the default apps, the apps you add are pinned.<CustomTaskbarLayoutCollection PinListPlacement="Replace">: Unpins the default apps. Only the apps you add are pinned. If you want to remove some of the default pinned apps, then addPinListPlacement="Replace". When you add your apps to<taskbar:TaskbarPinList>, include the default apps you still want pinned.
- In the
<defaultlayout:TaskbarLayout>node, useregion=" | "to use different taskbar configurations based on the device locale and region. - Save the file.
For practical examples of how to add, remove, or replace pinned apps, see the following sections:
Example: add pins
The <CustomTaskbarLayoutCollection> 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]
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 <CustomTaskbarLayoutCollection>.
[!INCLUDE example-remove-pins]
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 <CustomTaskbarLayoutCollection>. Then, add the pins that you want to TaskbarPinList.
[!INCLUDE example-replace-pins]
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]
- If the
<TaskbarPinList>node has region matching the one configured on the device, then the configuration applies. - If the
<TaskbarPinList>node doesn't have a region matching the one configured on the device, then the first<TaskbarPinList>node without region applies.
Note
Deploy the taskbar configuration
[!INCLUDE tab-intro]
:::image type="icon" source="../images/icons/intune.svg"::: Intune/CSP
To configure devices with Microsoft Intune, create a Settings catalog policy 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]
Alternatively, you can configure devices using a custom policy with the Start CSP. Use one of the following settings:
| Setting |
|---|
- OMA-URI: ./User/Vendor/MSFT/Policy/Config/Start/StartLayout- String: - Value: content of the XML file |
- OMA-URI: ./Device/Vendor/MSFT/Policy/Config/Start/StartLayout- Data type: - Value: content of the XML file |
[!INCLUDE intune-custom-settings-2]
:::image type="icon" source="../images/icons/provisioning-package.svg"::: PPKG
[!INCLUDE provisioning-package-1]
- 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
Valuefield. Use a text editor to remove any line breaks from the XML file, usually with a function called join lines.
[!INCLUDE provisioning-package-2]
:::image type="icon" source="../images/icons/group-policy.svg"::: GPO
To configure a device with group policy, use the Local Group Policy Editor. To configure multiple devices joined to Active Directory, create or edit 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]
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):