Homepage

Configure the default homepage and how Firefox starts.

This policy covers startup and the Home button. It does not change what a new tab shows: use the NewTabPage policy to turn the New Tab page off, or the FirefoxHome policy to change the sections on it.

Compatibility

Firefox	Firefox ESR	Firefox Enterprise
Available since 60	Available since 60	Available since 149

StartPage was added in Firefox 60, Firefox ESR 60.4, homepage-locked added in Firefox 78, NewTabOnRestore added in Firefox 153, Firefox ESR 153.

CCK2 Equivalent: homePage,lockHomePage
OMA-URI: Homepage
Preferences Affected: browser.startup.homepage, browser.startup.page, browser.sessionstore.newTabOnRestore, browser.sessionstore.newTabOnRestore.showSetting

Examples

{
  "policies": {
    "Homepage": {
      "URL": "http://example.com/",
      "Locked": true,
      "Additional": [
        "http://example.org/",
        "http://example.edu/"
      ],
      "StartPage": "none"
    }
  }
}

JSON schema

{
  "type": "object",
  "properties": {
    "URL": {
      "type": "string",
      "format": "uri"
    },
    "Locked": {
      "type": "boolean"
    },
    "Additional": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "StartPage": {
      "type": "string",
      "enum": [
        "none",
        "homepage",
        "previous-session",
        "homepage-locked"
      ]
    },
    "NewTabOnRestore": {
      "type": "boolean"
    }
  }
}

Values

The following members are configurable:

URL is the default homepage.
Locked prevents the user from changing homepage preferences.
Additional allows for more than one homepage.
StartPage is how Firefox starts. Expects one of the following values:
- none: Start with a blank page (no homepage, no previous session).
- homepage: Start with the homepage in URL policy.
- previous-session: Restore the previous session (all tabs and windows reopen).
- homepage-locked: Always force the homepage at startup, users cannot choose session restore. (Firefox 78)
NewTabOnRestore (Firefox 153) controls the "Also open new tab" option under Settings, in the Startup section. When it is enabled, Firefox opens an extra tab whenever it restores your previous windows and tabs at startup. Firefox may turn this option on for your users on its own, so set NewTabOnRestore to false to keep it off, or true to always enable it.

Windows (GPO)

Software\Policies\Mozilla\Firefox\Homepage\URL = "https://example.com"
Software\Policies\Mozilla\Firefox\Homepage\Locked = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\Homepage\Additional\1 = "https://example.org"
Software\Policies\Mozilla\Firefox\Homepage\Additional\2 = "https://example.edu"
Software\Policies\Mozilla\Firefox\Homepage\StartPage = "none" | "homepage" | "previous-session" | "homepage-locked"
Software\Policies\Mozilla\Firefox\Homepage\NewTabOnRestore = 0x1 | 0x0

macOS

<dict>
  <key>Homepage</key>
  <dict>
    <key>URL</key>
    <string>http://example.com</string>
    <key>Locked</key>
    <true/> | <false/>
    <key>Additional</key>
    <array>
      <string>http://example.org</string>
      <string>http://example.edu</string>
    </array>
    <key>StartPage</key>
    <string>none | homepage | previous-session | homepage-locked</string>
    <key>NewTabOnRestore</key>
    <true/> | <false/>
  </dict>
</dict>