Edit

Share via

HomepageLocation

  • Article

Configure the home page URL

Supported versions

  • On Windows and macOS since 77 or later

Description

Configures the default home page URL in Microsoft Edge.

The home page is the page opened by the Home button. The pages that open on startup are controlled by the RestoreOnStartup policies.

You can either set a URL here or set the home page to open the new tab page 'edge://newtab'. By default, the Home button will open the new tab page (as configured by the user or with the policy NewTabPageLocation), and the user will be able to choose between the URL configured by this policy and the new tab page.

If you enable this policy, users can't change their home page URL, but they can choose the behavior for the Home button to open either the set URL or the new tab page. If you wish to enforce the usage of the set URL you must also configure HomepageIsNewTabPage=Disabled.

If you disable or don't configure this policy, users can choose their own home page, as long as the HomepageIsNewTabPage policy isn't enabled.

This policy is available only on Windows instances that are joined to a Microsoft Active Directory ___domain, joined to Microsoft Azure Active Directory, or instances that enrolled for device management. On macOS, this policy is available only on instances that are managed via MDM or joined to a ___domain via MCX.

Supported features

  • Can be mandatory: Yes
  • Can be recommended: Yes
  • Dynamic Policy Refresh: Yes
  • Per Profile: Yes
  • Applies to a profile that is signed in with a Microsoft account: No

Data type

  • String

Windows information and settings

Group Policy (ADMX) info

  • GP unique name: HomepageLocation
  • GP name: Configure the home page URL
  • GP path (Mandatory): Administrative Templates/Microsoft Edge/Startup, home page and new tab page
  • GP path (Recommended): Administrative Templates/Microsoft Edge - Default Settings (users can override)/Startup, home page and new tab page
  • GP ADMX file name: MSEdge.admx

Example value

https://www.contoso.com

Registry settings

  • Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge
  • Path (Recommended): SOFTWARE\Policies\Microsoft\Edge\Recommended
  • Value name: HomepageLocation
  • Value type: REG_SZ

Example registry value

https://www.contoso.com

Mac information and settings

  • Preference Key name: HomepageLocation
  • Example value:
<string>https://www.contoso.com</string>

See also