Skip to content

Document Homepage NewTabOnRestore (Firefox 153) #238

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mkaply merged 1 commit into from
Jul 21, 2026
Merged

Document Homepage NewTabOnRestore (Firefox 153) #238

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions src/content/docs/reference/policies/Homepage.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ category: "Startup"

Configure the default homepage and how Firefox starts.

**Compatibility:** Firefox 60, Firefox ESR 60 (StartPage was added in Firefox 60, Firefox ESR 60.4, homepage-locked added in Firefox 78)\
**Compatibility:** Firefox 60, Firefox ESR 60 (StartPage was added in Firefox 60, Firefox ESR 60.4, homepage-locked added in Firefox 78, NewTabOnRestore added in Firefox 154)\
**CCK2 Equivalent:** `homePage`,`lockHomePage`\
**Preferences Affected:** `browser.startup.homepage`, `browser.startup.page`
**Preferences Affected:** `browser.startup.homepage`, `browser.startup.page`, `browser.sessionstore.newTabOnRestore`, `browser.sessionstore.newTabOnRestore.showSetting`

## Examples

Expand All @@ -27,6 +27,10 @@ The following members are configurable:
- `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 154) 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.

> [!NOTE]
> Firefox may turn on "Also open new tab" for your users on its own. If you don't want your users to suddenly get an extra tab when their previous windows and tabs are restored, set `NewTabOnRestore` to `false`.

## Windows (GPO)

Expand All @@ -36,6 +40,7 @@ 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
```

## Windows (Intune)
Expand Down Expand Up @@ -100,6 +105,8 @@ Value (string):
</array>
<key>StartPage</key>
<string>none | homepage | previous-session | homepage-locked</string>
<key>NewTabOnRestore</key>
<true/> | <false/>
</dict>
</dict>
```