diff --git a/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx b/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx index b11986d..9f8bbfc 100644 --- a/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx +++ b/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx @@ -22,6 +22,11 @@ To suppress the startup check without removing the controls from browser prefere +## Values + +- Set to `true` to check whether Firefox is the default browser at startup, and lock the setting. +- Set to `false` to stop the check, remove the option to make Firefox the default browser, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx index 8b720b9..34006c9 100644 --- a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx @@ -19,6 +19,13 @@ You can use `${home}` for the native home directory. +## Values + +`DefaultDownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`. +The user can still change it. + +- `${home}` expands to the user's home directory, so `${home}/Downloads` works across profiles and platforms. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableAccounts.mdx b/src/content/docs/reference/policies/DisableAccounts.mdx index 003c1b7..e086493 100644 --- a/src/content/docs/reference/policies/DisableAccounts.mdx +++ b/src/content/docs/reference/policies/DisableAccounts.mdx @@ -17,6 +17,11 @@ Disable account-based services, including sync. +## Values + +- Set to `true` to disable account-based services, including sync, and block signing in. +- Set to `false` to leave account-based services available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableAppUpdate.mdx b/src/content/docs/reference/policies/DisableAppUpdate.mdx index 365881c..b6bd348 100644 --- a/src/content/docs/reference/policies/DisableAppUpdate.mdx +++ b/src/content/docs/reference/policies/DisableAppUpdate.mdx @@ -17,6 +17,11 @@ Turn off application updates within Firefox. +## Values + +- Set to `true` to stop Firefox updating itself. +- Set to `false` to leave updates enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx index a21225b..34fde57 100644 --- a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx +++ b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx @@ -21,6 +21,13 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally. +## Values + +- Set to `true` to hand PDF files to the operating system's default PDF handler. +- Set to `false` to open PDF files in Firefox. Unlike most policies, this actively sets the handler back to the built-in viewer rather than doing nothing. + +If the [`Handlers`](/reference/policies/handlers/) policy already configures `application/pdf` or the `pdf` extension, that policy wins and `DisableBuiltinPDFViewer` is ignored. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx index def156d..988edbf 100644 --- a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx +++ b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx @@ -23,6 +23,11 @@ Windows only. +## Values + +- Set to `true` to stop the Windows default browser agent running. +- Set to `false` to leave the agent running. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDeveloperTools.mdx b/src/content/docs/reference/policies/DisableDeveloperTools.mdx index 1c10c9a..94ee38d 100644 --- a/src/content/docs/reference/policies/DisableDeveloperTools.mdx +++ b/src/content/docs/reference/policies/DisableDeveloperTools.mdx @@ -17,6 +17,11 @@ Remove access to all developer tools. +## Values + +- Set to `true` to disable the developer tools and block `about:debugging`, `about:devtools-toolbox` and `about:profiling`. +- Set to `false` to leave the developer tools available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx index 0ca9405..37578b4 100644 --- a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx +++ b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx @@ -18,6 +18,11 @@ Note that TLS Client Hellos will still contain an ECH extension, but this extens +## Values + +- Set to `true` to disable Encrypted Client Hello (ECH) for both DNS and HTTP/3. +- Set to `false` to leave ECH enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx index 39456e6..4e1f145 100644 --- a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx +++ b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx @@ -17,6 +17,11 @@ Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site). +## Values + +- Set to `true` to remove the Submit Feedback and Report Deceptive Site items from the Help menu. +- Set to `false` to leave the menu items in place. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx index d74767d..ef44c60 100644 --- a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx @@ -17,6 +17,13 @@ Disable Firefox Accounts integration (Sync). +## Values + +- Set to `true` to disable Firefox accounts and sync. +- Set to `false` to leave Firefox accounts available. This is the same as not setting the policy. + +If [`DisableAccounts`](/reference/policies/disableaccounts/) is also set, it takes precedence and `DisableFirefoxAccounts` is ignored. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx index 036c966..e38e58a 100644 --- a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx @@ -17,6 +17,11 @@ Remove access to Firefox Screenshots. +## Values + +- Set to `true` to remove Firefox Screenshots. +- Set to `false` to leave Firefox Screenshots available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx index 4938a62..e519e5d 100644 --- a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx @@ -17,6 +17,11 @@ Disable Firefox studies (Shield). +## Values + +- Set to `true` to stop Firefox running studies, and turn off add-on and feature recommendations. +- Set to `false` to leave studies enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableForgetButton.mdx b/src/content/docs/reference/policies/DisableForgetButton.mdx index 7b9f467..41a0516 100644 --- a/src/content/docs/reference/policies/DisableForgetButton.mdx +++ b/src/content/docs/reference/policies/DisableForgetButton.mdx @@ -17,6 +17,11 @@ Disable the "Forget" button. +## Values + +- Set to `true` to remove the Forget button. +- Set to `false` to leave the Forget button available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFormHistory.mdx b/src/content/docs/reference/policies/DisableFormHistory.mdx index 4706307..c4c8795 100644 --- a/src/content/docs/reference/policies/DisableFormHistory.mdx +++ b/src/content/docs/reference/policies/DisableFormHistory.mdx @@ -17,6 +17,11 @@ Turn off saving information on web forms and the search bar. +## Values + +- Set to `true` to stop Firefox remembering form and search history. +- Set to `false` to leave form and search history enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx b/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx index b9a2c6a..801d397 100644 --- a/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx +++ b/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx @@ -25,6 +25,11 @@ Windows and macOS only; Windows in Firefox 155, and macOS in Firefox 156. +## Values + +- Set to `true` to remove the option to launch Firefox on login, and turn the setting off if it is already on. +- Set to `false` to leave the option available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableLocalPolicies.mdx b/src/content/docs/reference/policies/DisableLocalPolicies.mdx index cb924ae..2e29919 100644 --- a/src/content/docs/reference/policies/DisableLocalPolicies.mdx +++ b/src/content/docs/reference/policies/DisableLocalPolicies.mdx @@ -16,3 +16,8 @@ Disable reading policies from local policy sources. :::caution[Limitation] The policy cannot be applied by policies.json, Windows GPO or macOS plist. ::: + +## Values + +- Set to `true` to stop Firefox reading policies from local policy sources. +- Set to `false` to read local policy sources. This is the same as not setting the policy. diff --git a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx index dfc4c08..2309807 100644 --- a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx +++ b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx @@ -21,6 +21,11 @@ If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/reference/polic +## Values + +- Set to `true` to remove the option to create a primary password. An existing primary password can still be removed. +- Set to `false` to leave primary password creation available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePasswordReveal.mdx b/src/content/docs/reference/policies/DisablePasswordReveal.mdx index ab14bf1..2305a64 100644 --- a/src/content/docs/reference/policies/DisablePasswordReveal.mdx +++ b/src/content/docs/reference/policies/DisablePasswordReveal.mdx @@ -17,6 +17,11 @@ Do not allow passwords to be shown in saved logins. +## Values + +- Set to `true` to stop users revealing saved passwords. +- Set to `false` to allow saved passwords to be revealed. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePocket.mdx b/src/content/docs/reference/policies/DisablePocket.mdx index 28c7bc1..cc50653 100644 --- a/src/content/docs/reference/policies/DisablePocket.mdx +++ b/src/content/docs/reference/policies/DisablePocket.mdx @@ -17,6 +17,11 @@ Remove Pocket in the Firefox UI. It does not remove it from the new tab page. +## Values + +- Set to `true` to remove Pocket from the Firefox UI. +- Set to `false` to leave Pocket in place. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx index bc922b5..095f94f 100644 --- a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx +++ b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx @@ -21,6 +21,11 @@ Remove access to private browsing. +## Values + +- Set to `true` to disable private browsing and block `about:privatebrowsing`. +- Set to `false` to leave private browsing available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileImport.mdx b/src/content/docs/reference/policies/DisableProfileImport.mdx index 8e427b9..1473558 100644 --- a/src/content/docs/reference/policies/DisableProfileImport.mdx +++ b/src/content/docs/reference/policies/DisableProfileImport.mdx @@ -17,6 +17,11 @@ Remove the ability to import data from other browsers. +## Values + +- Set to `true` to remove the option to import data from another browser, including the import wizard. +- Set to `false` to leave importing available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileRefresh.mdx b/src/content/docs/reference/policies/DisableProfileRefresh.mdx index abae2a3..048952b 100644 --- a/src/content/docs/reference/policies/DisableProfileRefresh.mdx +++ b/src/content/docs/reference/policies/DisableProfileRefresh.mdx @@ -17,6 +17,11 @@ Disable the Refresh Firefox button on `about:support` and `support.mozilla.org`, +## Values + +- Set to `true` to remove the Refresh Firefox button from `about:support`, and stop Firefox prompting the user to refresh. +- Set to `false` to leave the Refresh Firefox button available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx index 8c489c2..943c695 100644 --- a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx +++ b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx @@ -17,6 +17,11 @@ Prevent Firefox from applying performance, stability, and feature changes betwee +## Values + +- Set to `true` to stop Firefox applying remotely configured changes between updates. +- Set to `false` to leave remote improvements enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx b/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx index e011459..1ecd705 100644 --- a/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx +++ b/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx @@ -22,6 +22,11 @@ Remote Settings is the mechanism Firefox uses to deliver frequently updated data +## Values + +- Set to `true` to stop Firefox connecting to Remote Settings, including for the add-on and plugin blocklists. +- Set to `false` to leave Remote Settings enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSafeMode.mdx b/src/content/docs/reference/policies/DisableSafeMode.mdx index acf22de..f69c4f5 100644 --- a/src/content/docs/reference/policies/DisableSafeMode.mdx +++ b/src/content/docs/reference/policies/DisableSafeMode.mdx @@ -21,6 +21,11 @@ Windows and macOS only. +## Values + +- Set to `true` to disable safe mode. On Windows, this also disables starting in safe mode from the command line. +- Set to `false` to leave safe mode available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx index 6da5401..83b31db 100644 --- a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx +++ b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx @@ -17,6 +17,11 @@ Remove the "Set As Desktop Background..." menuitem when right clicking on an ima +## Values + +- Set to `true` to remove the Set as Desktop Background item from the image context menu. +- Set to `false` to leave the menu item in place. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx index 6d521fe..e2cafe0 100644 --- a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx +++ b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx @@ -22,6 +22,11 @@ If this policy is set to `true`, Firefox does not install new system add-ons or +## Values + +- Set to `true` to stop Firefox installing or updating system add-ons. +- Set to `false` to leave system add-on updates enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableTelemetry.mdx b/src/content/docs/reference/policies/DisableTelemetry.mdx index 98fe307..31c56f3 100644 --- a/src/content/docs/reference/policies/DisableTelemetry.mdx +++ b/src/content/docs/reference/policies/DisableTelemetry.mdx @@ -22,6 +22,11 @@ From Firefox 83 and Firefox ESR 78.5, local storage of telemetry data is also di +## Values + +- Set to `true` to stop telemetry being collected and uploaded, and block `about:telemetry`. +- Set to `false` to leave telemetry enabled. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx index 03d90ea..b109256 100644 --- a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx +++ b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx @@ -21,6 +21,11 @@ Windows only, GPO only. +## Values + +- Set to `true` to stop users blocking third-party modules from `about:third-party`. +- Set to `false` to leave third-party module blocking available. This is the same as not setting the policy. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx index 1df0e92..29d6f48 100644 --- a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx +++ b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx @@ -22,6 +22,11 @@ To remove the controls to set Firefox as the default browser, see the [`DefaultB +## Values + +- Set to `true` to stop Firefox checking whether it is the default browser at startup, and lock the setting. +- Set to `false` to check at startup whether Firefox is the default browser, and lock the setting. + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DownloadDirectory.mdx b/src/content/docs/reference/policies/DownloadDirectory.mdx index 5d07cf2..c5657ae 100644 --- a/src/content/docs/reference/policies/DownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DownloadDirectory.mdx @@ -18,6 +18,13 @@ You can use `${home}` for the native home directory. +## Values + +`DownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`. +The path is locked, and the user cannot choose where each file is saved. + +- `${home}` expands to the user's home directory, so `${home}/Downloads` works across profiles and platforms. + ## Windows (GPO) ```