Add image for secondary Microsoft Edge tiles
- Windows 10
- Windows 10 Mobile
App tiles are the Start screen tiles that represent and launch an app. A tile that allows a user to go to a specific location in an app is a secondary tile. Some examples of secondary tiles include:
- Weather updates for a specific city in a weather app
- A summary of upcoming events in a calendar app
- Status and updates from an important contact in a social app
- A website in Microsoft Edge
In a Start layout for Windows 10, version 1703, you can include secondary tiles for Microsoft Edge that display a custom image, rather than a tile with the standard Microsoft Edge logo.
Suppose that the Start layout that you export had two secondary tiles, such as in the following image:
In prior versions of Windows 10, when you applied the Start layout to a device, the tiles would display as shown in the following image:
In Windows 10, version 1703, by using the PowerShell cmdlet
export-StartLayoutEdgeAssets and the policy setting
ImportEdgeAssets, the tiles will now display the same as they did on the device from which you exported the Start layout.
Example of secondary tiles in XML generated by Export-StartLayout
<start:SecondaryTile AppUserModelID="Microsoft.Windows.Edge_cw5n1h2txyewy!Microsoft.Edge.Edge" TileID="-9513911450" DisplayName="Bing" Size="2x2" Column="0" Row="0" Arguments="-contentTile -formatVersion 0x00000003 -pinnedTimeLow 0x36a8c2e4 -pinnedTimeHigh 0x01d0919b -securityFlags 0x00000000 -tileType 0x00000000 -url 0x00000014 http://www.bing.com/" Square150x150LogoUri="ms-appdata:///local/PinnedTiles/-9513911450/lowres.png" Wide310x150LogoUri="ms-appx:///" ShowNameOnSquare150x150Logo="true" ShowNameOnWide310x150Logo="true" BackgroundColor="#7fffffff" />
Export Start layout and assets
- Follow the instructions in Customize and export Start layout to customize the Start screen on your test computer.
Open Windows PowerShell as an administrator and enter the following command:
Export-StartLayout -path <path><file name>.xml
In the previous command,
-pathis a required parameter that specifies the path and file name for the export file. You can specify a local path or a UNC path (for example, \\FileServer01\StartLayouts\StartLayoutMarketing.xml).
Use a file name of your choice—for example, StartLayoutMarketing.xml. Include the .xml file name extension. The Export-StartLayout cmdlet does not append the file name extension, and the policy settings require the extension.
If you’d like to change the image for a secondary tile to your own custom image, open the layout.xml file, and look for the images that the tile references.
- For example, your layout.xml contains
C:\Users\<username>\AppData\Local\Packages\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\LocalState\PinnedTiles\21581260870\and replace those images with your customized images.
A quick method for getting appropriately sized images for each tile size is to upload your image at BuildMyPinnedSite and then download the resized tile images.
- For example, your layout.xml contains
In Windows PowerShell, enter the following command:
Configure policy settings
You can apply the customized Start layout with images for secondary tiles by using mobile device management or a provisioning package. However, because you are including the images for secondary tiles, you must configure an additional setting to import the Edge assets.
In Microsoft Intune, you create a device restrictions policy to apply to device group. For other MDM solutions, you may need to use an OMA-URI setting for Start layout, based on the Policy configuration service provider (CSP). The OMA-URI setting is
- In the Microsoft Azure portal, search for Intune or go to More services > Intune.
- Select Device configuration.
- Select Profiles.
- Select Create profile.
- Enter a friendly name for the profile.
- Select Windows 10 and later for the platform.
- Select Device restrictions for the profile type.
- Select Start.
- In Start menu layout, browse to and select your Start layout XML file.
- In Pin websites to tiles in Start menu, browse to and select your assets XML file.
- Select OK twice, and then select Create.
- Assign the profile to a group.
The device restrictions in Microsoft Intune include other Start settings that you can also configure in your profile.
Using a provisioning package
Prepare the Start layout and Edge assets XML files
The export-StartLayout and export-StartLayoutEdgeAssets cmdlets produce XML files. Because Windows Configuration Designer produces a customizations.xml file that contains the configuration settings, adding the Start layout and Edge assets sections to the customizations.xml file directly would result in an XML file embedded in an XML file. Before you add the Start layout and Edge assets sections to the customizations.xml file, you must replace the markup characters in your layout.xml with escape characters.
Copy the contents of layout.xml into an online tool that escapes characters.
Copy the contents of assets.xml into an online tool that escapes characters.
During the procedure to create a provisioning package, you will copy the text with the escape characters and paste it in the customizations.xml file for your project.
Use the Windows Configuration Designer tool to create a provisioning package. Learn how to install Windows Configuration Designer.
When you build a provisioning package, you may include sensitive information in the project files and in the provisioning package (.ppkg) file. Although you have the option to encrypt the .ppkg file, project files are not encrypted. You should store the project files in a secure location and delete the project files when they are no longer needed.
Open Windows Configuration Designer (by default, %systemdrive%\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Imaging and Configuration Designer\x86\ICD.exe).
Choose Advanced provisioning.
Name your project, and click Next.
Choose All Windows desktop editions and click Next.
On New project, click Finish. The workspace for your package opens.
Expand Runtime settings > Policies > Start, and click StartLayout.
If Start is not listed, check the type of settings you selected in step 4. You must create the project using settings for All Windows desktop editions.
Enter layout.xml. This value creates a placeholder in the customizations.xml file that you will replace with the contents of the layout.xml file in a later step.
In the Available customizations pane, select ImportEdgeAssets.
Enter assets.xml. This value creates a placeholder in the customizations.xml file that you will replace with the contents of the assets.xml file in a later step.
Save your project and close Windows Configuration Designer.
In File Explorer, open the project's directory. (The default location is C:\Users\user name\Documents\Windows Imaging and Configuration Designer (WICD)\project name)
Open the customizations.xml file in a text editor. The <Customizations> section will look like this:
Replace layout.xml with the text from the layout.xml file, with markup characters replaced with escape characters.
Replace assets.xml with the text from the assets.xml file, with markup characters replaced with escape characters.
Save and close the customizations.xml file.
Open Windows Configuration Designer and open your project.
On the File menu, select Save.
On the Export menu, select Provisioning package.
Change Owner to IT Admin, which will set the precedence of this provisioning package higher than provisioning packages applied to this device from other sources, and then select Next.
Optional. In the Provisioning package security window, you can choose to encrypt the package and enable package signing.
Enable package encryption - If you select this option, an auto-generated password will be shown on the screen.
Enable package signing - If you select this option, you must select a valid certificate to use for signing the package. You can specify the certificate by clicking Select... and choosing the certificate you want to use to sign the package.
Click Next to specify the output location where you want the provisioning package to go when it's built. By default, Windows Imaging and Configuration Designer (ICD) uses the project folder as the output location.
Optionally, you can click Browse to change the default output location.
Click Build to start building the package. The provisioning package doesn't take long to build. The project information is displayed in the build page and the progress bar indicates the build status.
If you need to cancel the build, click Cancel. This cancels the current build process, closes the wizard, and takes you back to the Customizations Page.
If your build fails, an error message will show up that includes a link to the project folder. You can scan the logs to determine what caused the error. Once you fix the issue, try building the package again.
If your build is successful, the name of the provisioning package, output directory, and project directory will be shown.
- If you choose, you can build the provisioning package again and pick a different path for the output package. To do this, click Back to change the output package name and path, and then click Next to start another build.
- If you are done, click Finish to close the wizard and go back to the Customizations Page.
Copy the provisioning package to the target device.
Double-click the ppkg file and allow it to install.
- Manage Windows 10 Start and taskbar layout
- Configure Windows 10 taskbar
- Customize and export Start layout
- Start layout XML for desktop editions of Windows 10 (reference)
- Customize Windows 10 Start and taskbar with Group Policy
- Customize Windows 10 Start and taskbar with provisioning packages
- Customize Windows 10 Start and tasbkar with mobile device management (MDM)
- Changes to Start policies in Windows 10
Send feedback about: