Browser (Windows Configuration Designer reference)

  • Article

Use to configure browser settings that should only be set by OEMs who are part of the Partner Search Code program.

Applies to

Setting groups Windows client Surface Hub HoloLens IoT Core
AllowPrelaunch ✅
FavoriteBarItems ✅
Favorites
PartnerSearchCode ✅ ✅
SearchProviders

AllowPrelaunch

Use this setting to allow Microsoft Edge to pre-launch during Windows sign-in, when the system is idle, and each time that Microsoft Edge is closed. Pre-launch minimizes the amount of time required to start Microsoft Edge.

Select between Prevent Pre-launching and Allow Pre-launching.

FavoriteBarItems

Use to add items to the Favorites Bar in Microsoft Edge.

  1. Enter a name for the item, and select Add. (The name you enter here's only used to distinguish the group of settings, and isn't shown on the device when the settings are applied.)
  2. In Available customizations, select the item that you added, and then configure the following settings for that item:
Setting Description
ItemFavIconFile Enter the path to the icon file, local to the device where the browser will run. The icon file must be added to the device to the specified path.
ItemName Enter the name for the item, which will be displayed on the Favorites Bar.
ItemUrl Enter the target URL for the item.

Favorites

Use to configure the default list of Favorites that show up in the browser.

To add a new item under the browser's Favorites list:

  1. In the Name field, enter a friendly name for the item, and then click Add.
  2. In the Available customizations pane, select the friendly name that you created, and in the text field, enter the URL for the item.

For example, to include the corporate Web site to the list of browser favorites, a company called Contoso can specify Contoso as the value for the name and http://www.contoso.com for the URL.

PartnerSearchCode

Important

This setting should only be set by OEMs who are part of the Partner Search Code program.

Set the value to a character string that corresponds to the OEM's Partner Search Code. This identification code must match the one assigned to you by Microsoft.

OEMs who are part of the program only have one PartnerSearchCode which should be used for all Windows 10 for desktop editions images.

SearchProviders

Contains the settings you can use to configure the default and other search providers.

Default

Use Default to specify a name that matches one of the search providers you enter in SearchProviderList. If you don't specify a default search provider, this search provider will default to Microsoft Bing.

Specific region guidance

Some countries/regions require specific, default search providers. The following table lists the applicable countries/regions and information for configuring the necessary search provider.

Note

For Russia + Commonwealth of Independent States (CIS), the independent states consist of Russia, Ukraine, Georgia, The Republic of Azerbaijan, Republic Of Belarus, The Republic of Kazakhstan, The Kyrgyz Republic, The Republic of Moldova, The Republic of Tajikistan, The Republic of Armenia, Turkmenistan, The Republic of Uzbekistan, and Türkiye.

SearchProviderList

Use to specify a list of extra search providers.

  1. In the Name field, enter a name for the item, and then click Add.
  2. In the Available customizations pane, select the name that you created, and in the text field, enter the URL for the other search provider.

For example, to specify Yandex in Russia and Commonwealth of Independent States (CIS), set the value of URL to "https://yandex.ru/search/touch/?text={searchTerm}&clid=2234144".

When configured with multiple search providers, the browser can display up to 10 search providers.