From 3524958f2dd4347283a670f5d72216fa533cc305 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Thu, 5 Mar 2026 14:15:41 +0100 Subject: [PATCH 1/4] feat: Add Sync policy --- src/content/docs/reference/policies/Sync.mdx | 114 +++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 src/content/docs/reference/policies/Sync.mdx diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx new file mode 100644 index 0000000..d325961 --- /dev/null +++ b/src/content/docs/reference/policies/Sync.mdx @@ -0,0 +1,114 @@ +--- +title: "Sync" +description: "Controls whether Sync should be enabled and which features should be enabled for syncing." +category: "Local data storage" +--- + +Controls whether [Sync](https://www.firefox.com/en-US/features/sync/) should be enabled and which features should be enabled for syncing. + +**Compatibility:** Firefox 150.0.0\ +**CCK2 Equivalent:** N/A\ +**Preferences Affected:** N/A + +## Values + +- `Enabled`: A Boolean. Controls whether Sync itself should be enabled. +- `addresses`: A Boolean. Controls whether syncing addresses should be enabled. +- `bookmarks`: A Boolean. Controls whether syncing bookmarks should be enabled. +- `history`: A Boolean. Controls whether syncing history should be enabled. +- `openTabs`: A Boolean. Controls whether syncing open tabs should be enabled. +- `passwords`: A Boolean. Controls whether syncing passwords should be enabled. +- `paymentMethods`: A Boolean. Controls whether syncing payment Methods should be enabled. +- `addons`: A Boolean. Controls whether syncing addons should be enabled. +- `settings`: A Boolean. Controls whether syncing settings should be enabled. +- `Locked`: A Boolean. Controls whether to lock the customized Sync settings. + +## Windows (GPO) + +``` +Software\Policies\Mozilla\Firefox\Sync\Enabled = 0x1 +Software\Policies\Mozilla\Firefox\Sync\addresses = 0x1 +Software\Policies\Mozilla\Firefox\Sync\bookmarks = 0x1 +Software\Policies\Mozilla\Firefox\Sync\history = 0x1 +Software\Policies\Mozilla\Firefox\Sync\openTabs = 0x1 +Software\Policies\Mozilla\Firefox\Sync\passwords = 0x1 +Software\Policies\Mozilla\Firefox\Sync\paymentMethods = 0x1 +Software\Policies\Mozilla\Firefox\Sync\addons = 0x1 +Software\Policies\Mozilla\Firefox\Sync\settings = 0x1 +Software\Policies\Mozilla\Firefox\Sync\Locked = 0x1 +``` + +## Windows (Intune) + +OMA-URI: + +```url +./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Sync +``` + +Value (string): + +```xml + + + + + + + + + + + +``` + +## macOS + +```xml + + Sync + + Enabled + + addresses + + bookmarks + + history + + openTabs + + passwords + + paymentMethods + + addons + + settings + + Locked + + + +``` + +## policies.json + +```json +{ + "policies": { + "Sync": { + "Enabled": true, + "addresses": true, + "bookmarks": true, + "history": true, + "openTabs": true, + "passwords": true, + "paymentMethods": true, + "addons": true, + "settings": true, + "Locked": true + } + } +} +``` From f9d70f437d9add6074d807097251270b26fc2068 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 9 Mar 2026 13:40:11 +0100 Subject: [PATCH 2/4] Apply suggestion from @bsmth --- src/content/docs/reference/policies/Sync.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx index d325961..08c73b7 100644 --- a/src/content/docs/reference/policies/Sync.mdx +++ b/src/content/docs/reference/policies/Sync.mdx @@ -1,6 +1,6 @@ --- title: "Sync" -description: "Controls whether Sync should be enabled and which features should be enabled for syncing." +description: "Enable or disable sync and define which data to include." category: "Local data storage" --- From 416ecabddc1b1a17785497e3ca216bb8687aa4a0 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 9 Mar 2026 13:40:22 +0100 Subject: [PATCH 3/4] Apply suggestion from @1rneh Co-authored-by: Janika <92304290+1rneh@users.noreply.github.com> --- src/content/docs/reference/policies/Sync.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx index 08c73b7..2c52e11 100644 --- a/src/content/docs/reference/policies/Sync.mdx +++ b/src/content/docs/reference/policies/Sync.mdx @@ -18,7 +18,7 @@ Controls whether [Sync](https://www.firefox.com/en-US/features/sync/) should be - `history`: A Boolean. Controls whether syncing history should be enabled. - `openTabs`: A Boolean. Controls whether syncing open tabs should be enabled. - `passwords`: A Boolean. Controls whether syncing passwords should be enabled. -- `paymentMethods`: A Boolean. Controls whether syncing payment Methods should be enabled. +- `paymentMethods`: A Boolean. Controls whether syncing payment methods should be enabled. - `addons`: A Boolean. Controls whether syncing addons should be enabled. - `settings`: A Boolean. Controls whether syncing settings should be enabled. - `Locked`: A Boolean. Controls whether to lock the customized Sync settings. From 61ef96b9a13265183a3c22ddfbb86426ec45691d Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 9 Mar 2026 14:24:45 +0100 Subject: [PATCH 4/4] feat: Sync policy revision following reviewer comments --- src/content/docs/reference/policies/Sync.mdx | 125 ++++++++++--------- 1 file changed, 64 insertions(+), 61 deletions(-) diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx index 2c52e11..3ea7b34 100644 --- a/src/content/docs/reference/policies/Sync.mdx +++ b/src/content/docs/reference/policies/Sync.mdx @@ -4,38 +4,41 @@ description: "Enable or disable sync and define which data to include." category: "Local data storage" --- -Controls whether [Sync](https://www.firefox.com/en-US/features/sync/) should be enabled and which features should be enabled for syncing. +Controls whether [sync](https://www.firefox.com/en-US/features/sync/) should be enabled and which features should be enabled for syncing. -**Compatibility:** Firefox 150.0.0\ +> [!NOTE] +> Currently, this is only implemented in Firefox Enterprise. + +**Compatibility:** Firefox Enterprise 150.0.0\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A ## Values -- `Enabled`: A Boolean. Controls whether Sync itself should be enabled. -- `addresses`: A Boolean. Controls whether syncing addresses should be enabled. -- `bookmarks`: A Boolean. Controls whether syncing bookmarks should be enabled. -- `history`: A Boolean. Controls whether syncing history should be enabled. -- `openTabs`: A Boolean. Controls whether syncing open tabs should be enabled. -- `passwords`: A Boolean. Controls whether syncing passwords should be enabled. -- `paymentMethods`: A Boolean. Controls whether syncing payment methods should be enabled. -- `addons`: A Boolean. Controls whether syncing addons should be enabled. -- `settings`: A Boolean. Controls whether syncing settings should be enabled. -- `Locked`: A Boolean. Controls whether to lock the customized Sync settings. +- `Addons`: A Boolean. Controls whether syncing addons should be enabled. +- `Addresses`: A Boolean. Controls whether syncing addresses should be enabled. +- `Bookmarks`: A Boolean. Controls whether syncing bookmarks should be enabled. +- `Enabled`: A Boolean. Controls whether sync itself should be enabled. +- `History`: A Boolean. Controls whether syncing history should be enabled. +- `Locked`: A Boolean. Controls whether to lock the customized sync settings. +- `OpenTabs`: A Boolean. Controls whether syncing open tabs should be enabled. +- `Passwords`: A Boolean. Controls whether syncing passwords should be enabled. +- `PaymentMethods`: A Boolean. Controls whether syncing payment methods should be enabled. +- `Settings`: A Boolean. Controls whether syncing settings should be enabled. ## Windows (GPO) ``` -Software\Policies\Mozilla\Firefox\Sync\Enabled = 0x1 -Software\Policies\Mozilla\Firefox\Sync\addresses = 0x1 -Software\Policies\Mozilla\Firefox\Sync\bookmarks = 0x1 -Software\Policies\Mozilla\Firefox\Sync\history = 0x1 -Software\Policies\Mozilla\Firefox\Sync\openTabs = 0x1 -Software\Policies\Mozilla\Firefox\Sync\passwords = 0x1 -Software\Policies\Mozilla\Firefox\Sync\paymentMethods = 0x1 -Software\Policies\Mozilla\Firefox\Sync\addons = 0x1 -Software\Policies\Mozilla\Firefox\Sync\settings = 0x1 -Software\Policies\Mozilla\Firefox\Sync\Locked = 0x1 +Software\Policies\Mozilla\Firefox\Sync\Addons = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Addresses = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Bookmarks = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Enabled = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\History = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Locked = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\OpenTabs = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Passwords = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\PaymentMethods = 0x1 | 0x0 +Software\Policies\Mozilla\Firefox\Sync\Settings = 0x1 | 0x0 ``` ## Windows (Intune) @@ -49,17 +52,17 @@ OMA-URI: Value (string): ```xml - - - - - - - - - - - + or + + + + + + + + + + ``` ## macOS @@ -68,26 +71,26 @@ Value (string): Sync + Addons + | + Addresses + | + Bookmarks + | Enabled - - addresses - - bookmarks - - history - - openTabs - - passwords - - paymentMethods - - addons - - settings - + | + History + | Locked - + | + OpenTabs + | + Passwords + | + PaymentMethods + | + Settings + | ``` @@ -98,16 +101,16 @@ Value (string): { "policies": { "Sync": { - "Enabled": true, - "addresses": true, - "bookmarks": true, - "history": true, - "openTabs": true, - "passwords": true, - "paymentMethods": true, - "addons": true, - "settings": true, - "Locked": true + "Addons": true | false, + "Addresses": true | false, + "Bookmarks": true | false, + "Enabled": true | false, + "History": true | false, + "Locked": true | false, + "OpenTabs": true | false, + "Passwords": true | false, + "PaymentMethods": true | false, + "Settings": true | false } } }