From 09327e26c8be7cfd10a984ef465b18b79259dcb4 Mon Sep 17 00:00:00 2001 From: Michael Kaply <345868+mkaply@users.noreply.github.com> Date: Mon, 20 Jul 2026 18:27:02 -0400 Subject: [PATCH] Document SanitizeOnShutdown Exceptions (Firefox 154) --- src/content/docs/reference/policies/Cookies.mdx | 1 + .../docs/reference/policies/SanitizeOnShutdown.mdx | 8 +++++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/src/content/docs/reference/policies/Cookies.mdx b/src/content/docs/reference/policies/Cookies.mdx index e7a9139..b02c946 100644 --- a/src/content/docs/reference/policies/Cookies.mdx +++ b/src/content/docs/reference/policies/Cookies.mdx @@ -17,6 +17,7 @@ Configure cookie preferences. ## Values - `Allow` is a list of origins (not domains) where cookies are always allowed. You must include `http` or `https`. + As of Firefox 154, using `Allow` to also exempt sites from clearing on shutdown is deprecated. Firefox migrates those origins to the new mechanism, but you should configure [`SanitizeOnShutdown`](/reference/policies/sanitizeonshutdown/)'s `Exceptions` instead. - `AllowSession` is a list of origins (not domains) where cookies are only allowed for the current session. You must include `http` or `https`. - `Block` is a list of origins (not domains) where cookies are always blocked. You must include `http` or `https`. - `Behavior` sets the default behavior for cookies based on the following values: diff --git a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx index 74fc158..03a4593 100644 --- a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx +++ b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx @@ -10,7 +10,7 @@ Items that can be selectively deleted include browsing & download history, cooki > [!NOTE] Starting with Firefox 136, `FormData` and `History` are separate data types. -**Compatibility:** Firefox 60, Firefox ESR 60. Object form added in Firefox 68/ESR 68, `Locked` added in 74/68.6, `History` in Firefox 128.\ +**Compatibility:** Firefox 60, Firefox ESR 60. Object form added in Firefox 68/ESR 68, `Locked` added in 74/68.6, `History` in Firefox 128, `Exceptions` in Firefox 154.\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `privacy.sanitize.sanitizeOnShutdown`, `privacy.clearOnShutdown.cache`, `privacy.clearOnShutdown.cookies`, `privacy.clearOnShutdown.downloads`, `privacy.clearOnShutdown.formdata`, `privacy.clearOnShutdown.history`, `privacy.clearOnShutdown.sessions`, `privacy.clearOnShutdown.siteSettings`, `privacy.clearOnShutdown.offlineApps`, `privacy.clearOnShutdown_v2.browsingHistoryAndDownloads` (Firefox 128), `privacy.clearOnShutdown_v2.cookiesAndStorage` (Firefox 128), `privacy.clearOnShutdown_v2.cache` (Firefox 128), `privacy.clearOnShutdown_v2.siteSettings` (Firefox 128), `privacy.clearOnShutdown_v2.formdata` (Firefox 128) @@ -38,6 +38,7 @@ Accepts one or more of the following members to clear specific data types: - `SiteSettings`: Site preferences - `OfflineApps`: Offline Website Data (_Deprecated - use `Cookies` instead_) - `Locked`: Prevents the user from changing these preferences. +- `Exceptions`: (Firefox 154) A list of origins (not domains) whose cookies and site data are not cleared on shutdown. You must include `http` or `https`. ## Windows (GPO) @@ -57,6 +58,7 @@ Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\History = 0x1 | 0x0 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Sessions = 0x1 | 0x0 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\SiteSettings = 0x1 | 0x0 Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Locked = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\SanitizeOnShutdown\Exceptions\1 = "https://example.com" ``` ## Windows (Intune) @@ -188,6 +190,10 @@ Clear specific data types: | Locked | + Exceptions + + https://example.com + ```