Update docs for DisableRemoteImprovements

[policy-templates.git] / docs / index.md

diff --git a/docs/index.md b/docs/index.md
index 5786f1bca1e83a90b52b80a82f758f177d951224..df52a3505735f86712a7e9ca4fc4eef196d0040b 100644 (file)
--- a/docs/index.md
+++ b/docs/index.md
@@ -58,6 +58,7 @@ Note: The `policies.json` must use the UTF-8 encoding.
 | **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
 | **[`DisableProfileImport`](#disableprofileimport)** | Remove the ability to import data from other browers.
 | **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org
+| **[`DisableRemoteImprovements`](#disableremoteimprovements)** | Prevent Firefox from applying performance, stability, and feature changes between updates.
 | **[`DisableSafeMode`](#disablesafemode)** | Disable safe mode within the browser.
 | **[`DisableSecurityBypass`](#disablesecuritybypass)** | Prevent the user from bypassing security in certain cases.
 | **[`DisableSetDesktopBackground`](#disablesetdesktopbackground)** | Remove the "Set As Desktop Background..." menuitem when right clicking on an image.
@@ -316,7 +317,7 @@ Value (string):
 
 Prevent Firefox from being updated beyond the specified version.
 
-You can specify the any version as ```xx.``` and Firefox will be updated with all minor versions, but will not be updated beyond the major version.
+You can specify the version as ```xx.``` and Firefox will be updated with all minor versions, but will not be updated beyond the major version.
 
 You can also specify the version as ```xx.xx.``` and Firefox will be updated with all patch versions, but will not be updated beyond the minor version.
 
@@ -2444,6 +2445,45 @@ Value (string):
   }
 }
 ```
+### DisableRemoteImprovements
+Prevent Firefox from applying performance, stability, and feature changes between updates.
+
+For more information, see https://support.mozilla.org/en-US/kb/remote-improvements.
+
+Note: This policy is not correctly reflected in preferences. This will be fixed soon.
+
+**Compatibility:** Firefox 148\
+**CCK2 Equivalent:** N/A
+**Preferences Affected:** N/A
+
+#### Windows (GPO)
+```
+Software\Policies\Mozilla\Firefox\DisableRemoteImprovements = 0x1 | 0x0
+```
+#### Windows (Intune)
+OMA-URI:
+```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/DisableRemoteImprovements
+```
+Value (string):
+```
+<enabled/> or <disabled/>
+```
+#### macOS
+```
+<dict>
+  <key>DisableRemoteImprovements</key>
+  <true/> | <false/>
+</dict>
+```
+#### policies.json
+```
+{
+  "policies": {
+    "DisableRemoteImprovements": true | false
+  }
+}
+```
 ### DisableSafeMode
 Disable safe mode within the browser.
 
@@ -2965,7 +3005,7 @@ IF `BaselineExceptions` is true, Firefox will automatically apply exceptions req
 
 If `ConvenienceExceptions`is true, Firefox will apply exceptions automatically that are only required to fix minor issues and make convenience features available. (Firefox 145)
 
-Note: Users can change `BaselineExceptions` and `ConvenienceExceptions` even when `Category` is set to ```strict``` unless `Locked` is set to true.
+Note: Users can change `BaselineExceptions` and `ConvenienceExceptions` even when `Category` is set to ```strict``` unless `Locked` is set to true. If `Locked` is set to true, the defaults are used unless a different value is specified in policy for `BaselineExceptions` and `ConvenienceExceptions`.
 
 **Compatibility:** Firefox 60, Firefox ESR 60 (Cryptomining and Fingerprinting added in 70/68.2, Exceptions added in 73/68.5. Category added in Firefox 142/140.2. BaselineExceptions and ConvenienceExceptions added in Firefox 145)\
 **CCK2 Equivalent:** N/A\
@@ -3373,7 +3413,8 @@ The configuration for each extension is another dictionary that can contain the
 #### Interaction Notes
 - `"installation_mode": "blocked"` takes precedence over all other settings. When set, extensions cannot be installed regardless of `allowed_types` or `install_sources`. A configuration for a specific extension ID still overrides the `"*"` configuration.
 - To block all extensions except a few, use `"installation_mode": "blocked"` for `"*"` and explicitly override it for allowed or force-installed extensions.
-- To block extensions but allow themes, dictionaries, and language packs, use `"allowed_types": ["theme", "dictionary", "locale"]` in the default (`"*"` ) configuration. (`"locale"` corresponds to Firefox language packs.)
+- To block extensions but allow themes, dictionaries, and language packs, leave the default (`"*"` ) `installation_mode` as `"allowed"` and set `"allowed_types": ["theme", "dictionary", "locale"]`. (`"locale"` corresponds to Firefox language packs.)
+  **Do not set `"installation_mode": "blocked"` in this scenario**, because `allowed_types` is ignored when installation is blocked.
 
 **Compatibility:** Firefox 69, Firefox ESR 68.1 (As of Firefox 85, Firefox ESR 78.7, installing a theme makes it the default.)\
 **CCK2 Equivalent:** N/A\