From 890d49d540eb3ac382dbea473a0470c0c33e3a62 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Tue, 22 Sep 2026 13:23:25 +0200 Subject: [PATCH] chore: Move Examples section after Values --- .../docs/reference/policies/3rdparty.mdx | 8 +- .../docs/reference/policies/AIChatbot.mdx | 8 +- .../docs/reference/policies/AIControls.mdx | 8 +- .../reference/policies/AccessConnector.mdx | 8 +- .../policies/AllowFileSelectionDialogs.mdx | 8 +- .../policies/AllowedDomainsForApps.mdx | 8 +- .../docs/reference/policies/AppAutoUpdate.mdx | 8 +- .../docs/reference/policies/AppUpdatePin.mdx | 8 +- .../docs/reference/policies/AppUpdateURL.mdx | 8 +- .../reference/policies/Authentication.mdx | 8 +- .../AutoLaunchProtocolsFromOrigins.mdx | 8 +- .../policies/AutofillAddressEnabled.mdx | 8 +- .../policies/AutofillCreditCardEnabled.mdx | 8 +- .../policies/BackgroundAppUpdate.mdx | 8 +- .../reference/policies/BlockAboutAddons.mdx | 8 +- .../reference/policies/BlockAboutConfig.mdx | 8 +- .../reference/policies/BlockAboutProfiles.mdx | 8 +- .../reference/policies/BlockAboutSupport.mdx | 8 +- .../docs/reference/policies/Bookmarks.mdx | 8 +- .../reference/policies/BrowserDataBackup.mdx | 8 +- .../policies/CNSA2KeyAgreementEnabled.mdx | 8 +- .../docs/reference/policies/CaptivePortal.mdx | 8 +- .../docs/reference/policies/Certificates.mdx | 8 +- .../reference/policies/ClearOnShutdown.mdx | 8 +- .../docs/reference/policies/Containers.mdx | 8 +- .../reference/policies/ContentAnalysis.mdx | 8 +- .../policies/ContentAnalysisTelemetry.mdx | 8 +- .../docs/reference/policies/Cookies.mdx | 8 +- .../reference/policies/CrashReportsSubmit.mdx | 8 +- .../docs/reference/policies/DNSOverHTTPS.mdx | 8 +- .../reference/policies/DataLossPrevention.mdx | 8 +- .../policies/DefaultBrowserSettingEnabled.mdx | 8 +- .../policies/DefaultDownloadDirectory.mdx | 8 +- .../policies/DefaultSerialGuardSetting.mdx | 10 +-- .../reference/policies/DisableAccounts.mdx | 8 +- .../reference/policies/DisableAppUpdate.mdx | 8 +- .../policies/DisableBuiltinPDFViewer.mdx | 8 +- .../policies/DisableDefaultBrowserAgent.mdx | 8 +- .../policies/DisableDeveloperTools.mdx | 8 +- .../policies/DisableEncryptedClientHello.mdx | 8 +- .../policies/DisableFeedbackCommands.mdx | 8 +- .../policies/DisableFirefoxAccounts.mdx | 8 +- .../policies/DisableFirefoxScreenshots.mdx | 8 +- .../policies/DisableFirefoxStudies.mdx | 8 +- .../policies/DisableForgetButton.mdx | 8 +- .../reference/policies/DisableFormHistory.mdx | 8 +- .../policies/DisableLaunchOnLogin.mdx | 8 +- .../DisableMasterPasswordCreation.mdx | 8 +- .../policies/DisablePasswordReveal.mdx | 8 +- .../docs/reference/policies/DisablePocket.mdx | 8 +- .../policies/DisablePrivateBrowsing.mdx | 8 +- .../policies/DisableProfileImport.mdx | 8 +- .../policies/DisableProfileRefresh.mdx | 8 +- .../policies/DisableRemoteImprovements.mdx | 8 +- ...eSettingsAndAcceptSecurityConsequences.mdx | 8 +- .../reference/policies/DisableSafeMode.mdx | 8 +- .../policies/DisableSecurityBypass.mdx | 8 +- .../policies/DisableSetDesktopBackground.mdx | 8 +- .../policies/DisableSystemAddonUpdate.mdx | 8 +- .../reference/policies/DisableTelemetry.mdx | 8 +- .../DisableThirdPartyModuleBlocking.mdx | 8 +- .../reference/policies/DisabledCiphers.mdx | 8 +- .../policies/DisplayBookmarksToolbar.mdx | 8 +- .../reference/policies/DisplayMenuBar.mdx | 8 +- .../policies/DontCheckDefaultBrowser.mdx | 8 +- .../reference/policies/DownloadDirectory.mdx | 8 +- .../policies/EnableTrackingProtection.mdx | 8 +- .../policies/EncryptedMediaExtensions.mdx | 8 +- ...eTypePairsFromFileTypeDownloadWarnings.mdx | 8 +- .../reference/policies/ExtensionSettings.mdx | 8 +- .../reference/policies/ExtensionUpdate.mdx | 8 +- .../docs/reference/policies/Extensions.mdx | 8 +- .../docs/reference/policies/FirefoxHome.mdx | 8 +- .../reference/policies/FirefoxSuggest.mdx | 8 +- .../docs/reference/policies/GenerativeAI.mdx | 8 +- ...anetSiteForSingleWordEntryInAddressBar.mdx | 8 +- .../docs/reference/policies/Handlers.mdx | 8 +- .../policies/HardwareAcceleration.mdx | 8 +- .../docs/reference/policies/Homepage.mdx | 8 +- .../docs/reference/policies/HttpAllowlist.mdx | 8 +- .../docs/reference/policies/HttpsOnlyMode.mdx | 8 +- .../policies/IPProtectionAvailable.mdx | 8 +- .../policies/InstallAddonsPermission.mdx | 8 +- .../reference/policies/LegacyProfiles.mdx | 10 +-- .../LegacySameSiteCookieBehaviorEnabled.mdx | 8 +- ...SiteCookieBehaviorEnabledForDomainList.mdx | 8 +- .../reference/policies/LocalFileLinks.mdx | 8 +- .../reference/policies/LocalNetworkAccess.mdx | 8 +- .../reference/policies/ManagedBookmarks.mdx | 8 +- .../policies/ManualAppUpdateOnly.mdx | 8 +- .../reference/policies/MicrosoftEntraSSO.mdx | 8 +- .../reference/policies/NetworkPrediction.mdx | 8 +- .../docs/reference/policies/NewTabPage.mdx | 8 +- .../reference/policies/NoDefaultBookmarks.mdx | 8 +- .../reference/policies/OfferToSaveLogins.mdx | 8 +- .../policies/OfferToSaveLoginsDefault.mdx | 8 +- .../policies/OverrideFirstRunPage.mdx | 8 +- .../policies/OverridePostUpdatePage.mdx | 8 +- src/content/docs/reference/policies/PDFjs.mdx | 8 +- .../policies/PasswordManagerEnabled.mdx | 8 +- .../policies/PasswordManagerExceptions.mdx | 8 +- .../docs/reference/policies/Permissions.mdx | 8 +- .../reference/policies/PictureInPicture.mdx | 8 +- .../docs/reference/policies/PopupBlocking.mdx | 8 +- .../PostQuantumKeyAgreementEnabled.mdx | 8 +- .../docs/reference/policies/Preferences.mdx | 8 +- .../reference/policies/PrimaryPassword.mdx | 8 +- .../reference/policies/PrintingEnabled.mdx | 8 +- .../PrivateBrowsingModeAvailability.mdx | 8 +- .../policies/PromptForDownloadLocation.mdx | 8 +- src/content/docs/reference/policies/Proxy.mdx | 8 +- .../reference/policies/RelaunchRequired.mdx | 8 +- .../reference/policies/RequestedLocales.mdx | 8 +- .../docs/reference/policies/SSLVersionMax.mdx | 8 +- .../docs/reference/policies/SSLVersionMin.mdx | 8 +- .../reference/policies/SanitizeOnShutdown.mdx | 8 +- .../docs/reference/policies/SearchBar.mdx | 8 +- .../docs/reference/policies/SearchEngines.mdx | 8 +- .../policies/SearchSuggestEnabled.mdx | 8 +- .../reference/policies/SecurityDevices.mdx | 8 +- .../reference/policies/SecurityLogging.mdx | 8 +- .../reference/policies/ShowHomeButton.mdx | 8 +- .../docs/reference/policies/SignOut.mdx | 8 +- .../docs/reference/policies/SitePolicies.mdx | 84 +++++++++---------- .../reference/policies/SkipTermsOfUse.mdx | 8 +- .../StartDownloadsInTempDirectory.mdx | 8 +- .../docs/reference/policies/SupportMenu.mdx | 8 +- src/content/docs/reference/policies/Sync.mdx | 8 +- .../reference/policies/TranslateEnabled.mdx | 8 +- .../policies/UseSystemPrintDialog.mdx | 8 +- .../docs/reference/policies/UserMessaging.mdx | 8 +- .../policies/VisualSearchEnabled.mdx | 8 +- .../docs/reference/policies/Watermark.mdx | 8 +- .../docs/reference/policies/WebsiteFilter.mdx | 8 +- .../docs/reference/policies/WindowsSSO.mdx | 8 +- .../docs/reference/policies/XSLTEnabled.mdx | 8 +- 136 files changed, 584 insertions(+), 584 deletions(-) diff --git a/src/content/docs/reference/policies/3rdparty.mdx b/src/content/docs/reference/policies/3rdparty.mdx index bff5fca..0ff02a6 100644 --- a/src/content/docs/reference/policies/3rdparty.mdx +++ b/src/content/docs/reference/policies/3rdparty.mdx @@ -8,16 +8,16 @@ Allow WebExtensions to configure policies. For more information, see [Adding policy support to your extension](https://extensionworkshop.com/documentation/enterprise/enterprise-development/#how-to-add-policy). For GPO and Intune, the extension developer should provide an ADMX file. -## Examples - - - ## Values - `Extensions`: An object keyed by extension ID. The value for each ID is the configuration passed to that extension. Firefox does not define those keys and values, the extension does, so check the extension's documentation for what it accepts. +## Examples + + + ## macOS ```xml diff --git a/src/content/docs/reference/policies/AIChatbot.mdx b/src/content/docs/reference/policies/AIChatbot.mdx index 79e8e97..bda070d 100644 --- a/src/content/docs/reference/policies/AIChatbot.mdx +++ b/src/content/docs/reference/policies/AIChatbot.mdx @@ -7,10 +7,6 @@ category: "Content settings" Configure the AI chatbot sidebar, including which built-in providers are available and the ability to add custom providers. For more information, see [Access AI chatbots in Firefox](https://support.mozilla.org/en-US/kb/ai-chatbot) on support.mozilla.org. -## Examples - - - ## Values - `Providers`: Configures the available AI chatbot providers. @@ -42,6 +38,10 @@ For more information, see [Access AI chatbots in Firefox](https://support.mozill - `Quiz` - `Proofread` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AIControls.mdx b/src/content/docs/reference/policies/AIControls.mdx index 3692ef3..e1a3826 100644 --- a/src/content/docs/reference/policies/AIControls.mdx +++ b/src/content/docs/reference/policies/AIControls.mdx @@ -7,10 +7,6 @@ category: "Miscellaneous" Configure AI controls. For more information, see [Block generative AI features with Firefox AI controls](https://support.mozilla.org/en-US/kb/firefox-ai-controls) on support.mozilla.org. -## Examples - - - ## Values Each key controls the availability of a specific AI feature. @@ -33,6 +29,10 @@ All keys accept the following sub-keys: For on-device AI, any models already downloaded are removed. - `Locked`: if `true`, the user cannot change the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AccessConnector.mdx b/src/content/docs/reference/policies/AccessConnector.mdx index 82db82a..8cf7bd9 100644 --- a/src/content/docs/reference/policies/AccessConnector.mdx +++ b/src/content/docs/reference/policies/AccessConnector.mdx @@ -8,10 +8,6 @@ Configure an Access Connector for proxying web traffic. When this policy is set, Firefox routes traffic through the server given by `Host` and `Port`. If `MatchPatterns` is set, only URLs matching those patterns are routed through the connector. -## Examples - - - ## Values - `Host`: A string that defines the hostname or IP address of the proxy server to use. @@ -23,6 +19,10 @@ If `MatchPatterns` is set, only URLs matching those patterns are routed through Unlike most policies, this defaults to `true`. Set it to `false` to apply the settings as defaults that users can still change. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx b/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx index 7c253d6..b7beade 100644 --- a/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx +++ b/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx @@ -6,15 +6,15 @@ category: "Browser UI" Enable or disable file selection dialogs. -## Examples - - - ## Values - Set to `true` to allow file selection dialogs. This is the same as omitting the policy. - Set to `false` to stop Firefox opening file selection dialogs. Downloads go straight to the download directory and the user cannot change that. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AllowedDomainsForApps.mdx b/src/content/docs/reference/policies/AllowedDomainsForApps.mdx index 00edbf5..6ec7366 100644 --- a/src/content/docs/reference/policies/AllowedDomainsForApps.mdx +++ b/src/content/docs/reference/policies/AllowedDomainsForApps.mdx @@ -8,10 +8,6 @@ Define domains allowed to access Google Workspace. This policy is based on the [Chrome policy](https://chromeenterprise.google/policies/#AllowedDomainsForApps) of the same name. If this policy is enabled, users can only access Google Workspace using accounts from the specified domains. If you want to allow Gmail, you can add `consumer_accounts` to the list. -## Examples - - - ## Values `AllowedDomainsForApps` expects a comma-separated list of domains, sent to Google as the `X-GoogApps-Allowed-Domains` header: @@ -19,6 +15,10 @@ If this policy is enabled, users can only access Google Workspace using accounts - A domain, such as `example.com`, allows Google Workspace accounts from that domain. - `consumer_accounts`: a keyword that allows personal Gmail accounts alongside whichever Workspace domains you list. See the [Chrome equivalent](https://chromeenterprise.google/policies/allowed-domains-for-apps/) for more details. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppAutoUpdate.mdx b/src/content/docs/reference/policies/AppAutoUpdate.mdx index f6e0373..27af0cb 100644 --- a/src/content/docs/reference/policies/AppAutoUpdate.mdx +++ b/src/content/docs/reference/policies/AppAutoUpdate.mdx @@ -11,15 +11,15 @@ When the policy is disabled, application updates are downloaded and the user can If you have disabled updates via [`DisableAppUpdate`](/reference/policies/disableappupdate/), this policy has no effect. -## Examples - - - ## Values - Set to `true` to install application updates without user approval, and prevent the user from turning automatic updates off. The operating system might still require approval. - Set to `false` to download updates but let the user choose when to install them, and prevent the user from turning automatic updates on. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppUpdatePin.mdx b/src/content/docs/reference/policies/AppUpdatePin.mdx index 4c74ea8..38eaa6a 100644 --- a/src/content/docs/reference/policies/AppUpdatePin.mdx +++ b/src/content/docs/reference/policies/AppUpdatePin.mdx @@ -18,10 +18,6 @@ You can specify a major and minor version as `xx.xx.` (e.g, `140.0.`) and Firefo You should specify a version that exists or is guaranteed to exist. If you specify a version that doesn't exist, Firefox will update beyond that version. -## Examples - - - ## Values `AppUpdatePin` expects a version prefix ending in a dot: @@ -29,6 +25,10 @@ If you specify a version that doesn't exist, Firefox will update beyond that ver - `MAJOR.`, such as `140.`, pins Firefox to the major version and allows every update within it. - `MAJOR.MINOR.`, such as `140.0.`, pins Firefox to the minor version and allows only patch updates within it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppUpdateURL.mdx b/src/content/docs/reference/policies/AppUpdateURL.mdx index ebde265..0b6a441 100644 --- a/src/content/docs/reference/policies/AppUpdateURL.mdx +++ b/src/content/docs/reference/policies/AppUpdateURL.mdx @@ -6,14 +6,14 @@ category: "Device update settings" Change the URL for application update if you are providing Firefox updates from a custom update server. -## Examples - - - ## Values `AppUpdateURL` expects the URL of the update XML on your update server, such as `https://www.example.com/update.xml`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Authentication.mdx b/src/content/docs/reference/policies/Authentication.mdx index 2ac3ec0..af81b9b 100644 --- a/src/content/docs/reference/policies/Authentication.mdx +++ b/src/content/docs/reference/policies/Authentication.mdx @@ -7,10 +7,6 @@ category: "Authentication" Configure sites that support integrated authentication. See [Integrated authentication](https://htmlpreview.github.io/?https://github.com/mdn/archived-content/blob/main/files/en-us/mozilla/integrated_authentication/raw.html) for more information. -## Examples - - - ## Values - `SPNEGO`: A list of sites permitted to use SPNEGO (Kerberos) authentication. @@ -25,6 +21,10 @@ See [Integrated authentication](https://htmlpreview.github.io/?https://github.co Unlike most policies, this defaults to `true`. Set it to `false` to apply the values as defaults that users can still change. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx index 37957d4..6de1cc3 100644 --- a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx +++ b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx @@ -10,10 +10,6 @@ The origin is the scheme (protocol), hostname (domain), and port of the URL used The syntax of this policy is the same as the [Chrome AutoLaunchProtocolsFromOrigins policy](https://chromeenterprise.google/policies/#AutoLaunchProtocolsFromOrigins) except that you can only use valid origins (not just hostnames). This also means that you cannot specify a wildcard (`*`) for all origins. -## Examples - - - ## Values Each entry in the list accepts the following keys: @@ -23,6 +19,10 @@ Each entry in the list accepts the following keys: Each origin is a scheme, hostname and optional port. Paths and wildcards are not supported. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutofillAddressEnabled.mdx b/src/content/docs/reference/policies/AutofillAddressEnabled.mdx index bf40d60..a4a3e24 100644 --- a/src/content/docs/reference/policies/AutofillAddressEnabled.mdx +++ b/src/content/docs/reference/policies/AutofillAddressEnabled.mdx @@ -9,15 +9,15 @@ Enables or disables autofill for addresses. This only applies when address autofill is enabled for a particular Firefox version or region. See [Automatically fill in your address on web forms](https://support.mozilla.org/kb/automatically-fill-your-address-web-forms) for more information. -## Examples - - - ## Values - Set to `true` to save and autofill addresses, and prevent the user from changing it. - Set to `false` to stop saving and autofilling addresses, and prevent the user from changing it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx b/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx index e41eeb3..9afba79 100644 --- a/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx +++ b/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx @@ -8,15 +8,15 @@ Enables or disables autofill for payment methods. This only applies when payment method autofill is enabled for a particular Firefox version or region. See [Automatically fill in credit card data](https://support.mozilla.org/kb/credit-card-autofill) for more information. -## Examples - - - ## Values - Set to `true` to save and autofill payment methods, and prevent the user from changing it. - Set to `false` to stop saving and autofilling payment methods, and prevent the user from changing it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx index 1eb815b..ca9ec3e 100644 --- a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx +++ b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx @@ -15,15 +15,15 @@ If you are having trouble getting the background task to run, verify your config > [!NOTE] > The `BackgroundAppUpdate` policy has no effect if you have disabled updates via the [`DisableAppUpdate`](/reference/policies/disableappupdate/) policy or disabled automatic updates via the [`AppAutoUpdate`](/reference/policies/appautoupdate/) policy. -## Examples - - - ## Values - Set to `true` to install updates in the background, and prevent the user from turning background updates off. - Set to `false` to stop updates being installed in the background, and prevent the user from turning them on. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutAddons.mdx b/src/content/docs/reference/policies/BlockAboutAddons.mdx index 0651255..65ea0fa 100644 --- a/src/content/docs/reference/policies/BlockAboutAddons.mdx +++ b/src/content/docs/reference/policies/BlockAboutAddons.mdx @@ -6,15 +6,15 @@ category: "Extensions" Block access to the Add-ons Manager (`about:addons`). -## Examples - - - ## Values - Set to `true` to block access to the Add-ons Manager (`about:addons`). - Set to `false` to leave the Add-ons Manager available. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutConfig.mdx b/src/content/docs/reference/policies/BlockAboutConfig.mdx index e1da3df..41fb886 100644 --- a/src/content/docs/reference/policies/BlockAboutConfig.mdx +++ b/src/content/docs/reference/policies/BlockAboutConfig.mdx @@ -6,15 +6,15 @@ category: "Security" Block access to Advanced Preferences (`about:config`). -## Examples - - - ## Values - Set to `true` to block access to `about:config`. This also turns off browser chrome debugging (`devtools.chrome.enabled`). - Set to `false` to leave `about:config` available. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutProfiles.mdx b/src/content/docs/reference/policies/BlockAboutProfiles.mdx index af1a608..89537ba 100644 --- a/src/content/docs/reference/policies/BlockAboutProfiles.mdx +++ b/src/content/docs/reference/policies/BlockAboutProfiles.mdx @@ -6,15 +6,15 @@ category: "Security" Block access to About Profiles (`about:profiles`). -## Examples - - - ## Values - Set to `true` to block the profile pages: `about:profiles`, `about:profilemanager`, `about:editprofile`, `about:newprofile` and `about:deleteprofile`. - Set to `false` to leave the profile pages available. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutSupport.mdx b/src/content/docs/reference/policies/BlockAboutSupport.mdx index a279b68..d6c03c8 100644 --- a/src/content/docs/reference/policies/BlockAboutSupport.mdx +++ b/src/content/docs/reference/policies/BlockAboutSupport.mdx @@ -6,15 +6,15 @@ category: "Security" Block access to Troubleshooting Information (`about:support`). -## Examples - - - ## Values - Set to `true` to block access to troubleshooting information (`about:support`). - Set to `false` to leave `about:support` available. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Bookmarks.mdx b/src/content/docs/reference/policies/Bookmarks.mdx index 35b778e..13d4955 100644 --- a/src/content/docs/reference/policies/Bookmarks.mdx +++ b/src/content/docs/reference/policies/Bookmarks.mdx @@ -12,10 +12,6 @@ Add bookmarks in either the bookmarks toolbar or menu. If you want to clear all bookmarks set with this policy, you can set the value to an empty array (`[]`). This can be on Windows via the new Bookmarks (JSON) policy available with GPO and Intune. -## Examples - - - ## Values Each entry in the list accepts the following keys: @@ -28,6 +24,10 @@ Each entry in the list accepts the following keys: - `Folder`: The name of a folder to put the bookmark in. The folder is created if it doesn't exist, and bookmarks that name the same folder are grouped together. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BrowserDataBackup.mdx b/src/content/docs/reference/policies/BrowserDataBackup.mdx index 4ad6789..74a5de9 100644 --- a/src/content/docs/reference/policies/BrowserDataBackup.mdx +++ b/src/content/docs/reference/policies/BrowserDataBackup.mdx @@ -10,10 +10,6 @@ Backup and restore can be disabled individually. > [!NOTE] > The policy can be used to disable backup and restore if it would otherwise be enabled, but cannot be used to force backup or restore to be enabled under conditions where it would not otherwise be (such as a platform on which backup or restore are not yet supported). -## Examples - - - ## Values `BrowserDataBackup` accepts either a boolean or an object. @@ -28,6 +24,10 @@ Both keys are locked, and a key that is left out keeps its existing value: - `AllowBackup`: Set to `false` to stop profile data being backed up. - `AllowRestore`: Set to `false` to stop a profile being restored from a backup. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/CNSA2KeyAgreementEnabled.mdx b/src/content/docs/reference/policies/CNSA2KeyAgreementEnabled.mdx index 916c5de..f71511c 100644 --- a/src/content/docs/reference/policies/CNSA2KeyAgreementEnabled.mdx +++ b/src/content/docs/reference/policies/CNSA2KeyAgreementEnabled.mdx @@ -12,15 +12,15 @@ ML-KEM-1024 is not offered by default. Setting this policy locks the preference, whether the value is `true` or `false`, so users cannot change it. -## Examples - - - ## Values - Set to `true` to enable ML-KEM-1024 key agreement, and prevent the user from changing it. - Set to `false` to disable ML-KEM-1024 key agreement, and prevent the user from changing it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/CaptivePortal.mdx b/src/content/docs/reference/policies/CaptivePortal.mdx index 67c1944..430e06f 100644 --- a/src/content/docs/reference/policies/CaptivePortal.mdx +++ b/src/content/docs/reference/policies/CaptivePortal.mdx @@ -6,15 +6,15 @@ category: "Network security" Enable or disable the detection of captive portals. -## Examples - - - ## Values - Set to `true` to enable captive portal detection, and prevent the user from changing it. - Set to `false` to disable captive portal detection, and prevent the user from changing it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Certificates.mdx b/src/content/docs/reference/policies/Certificates.mdx index d2780d7..5f8be5f 100644 --- a/src/content/docs/reference/policies/Certificates.mdx +++ b/src/content/docs/reference/policies/Certificates.mdx @@ -6,10 +6,6 @@ category: "Certificate management" Install and manage certificates in Firefox. -## Examples - - - ## Values `Certificates` accepts one or more of the following keys: @@ -43,6 +39,10 @@ Install and manage certificates in Firefox. Binary (DER) and ASCII (PEM) certificates are both supported. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ClearOnShutdown.mdx b/src/content/docs/reference/policies/ClearOnShutdown.mdx index 706509b..e4d7a7d 100644 --- a/src/content/docs/reference/policies/ClearOnShutdown.mdx +++ b/src/content/docs/reference/policies/ClearOnShutdown.mdx @@ -12,10 +12,6 @@ This policy supersedes [`SanitizeOnShutdown`](/reference/policies/sanitizeonshut Unlike `SanitizeOnShutdown`, only the categories an admin defines through policy are enforced. Omitted categories are under the user's control rather than being disabled. -## Examples - - - ## Values `ClearOnShutdown` accepts either a boolean or an object. @@ -38,6 +34,10 @@ Accepts one or more of the following members: > [!NOTE] > Every category the policy sets is locked, so there is no `Locked` option. +## Examples + + + ## Windows (GPO) Clear all data: diff --git a/src/content/docs/reference/policies/Containers.mdx b/src/content/docs/reference/policies/Containers.mdx index 359e8b2..c242a74 100644 --- a/src/content/docs/reference/policies/Containers.mdx +++ b/src/content/docs/reference/policies/Containers.mdx @@ -6,10 +6,6 @@ category: "Extensions" Set policies related to [Multi-Account Containers](https://addons.mozilla.org/firefox/addon/multi-account-containers/). -## Examples - - - ## Values Currently you can set the initial set of containers. @@ -24,6 +20,10 @@ For each container, you can specify the name, icon, and color. > [!NOTE] > As of Firefox 153, the available colors changed: `turquoise` was renamed to `cyan`, `toolbar` was renamed to `gray`, and `violet` was added. +## Examples + + + ## Windows (GPO) `Software\Policies\Mozilla\Firefox\Containers (REG_MULTI_SZ) =` diff --git a/src/content/docs/reference/policies/ContentAnalysis.mdx b/src/content/docs/reference/policies/ContentAnalysis.mdx index bcebea8..04580da 100644 --- a/src/content/docs/reference/policies/ContentAnalysis.mdx +++ b/src/content/docs/reference/policies/ContentAnalysis.mdx @@ -6,10 +6,6 @@ category: "Cloud reporting" Configure Firefox to use an agent for Data Loss Prevention (DLP) that is compatible with the [Google Chrome Content Analysis Connector Agent SDK](https://github.com/chromium/content_analysis_sdk). -## Examples - - - ## Values - `AgentName`: the name of the DLP agent. This is used in dialogs and notifications about DLP operations. The default is `A DLP Agent`. @@ -58,6 +54,10 @@ Configure Firefox to use an agent for Data Loss Prevention (DLP) that is compati - `1`: Warn the user and allow them to choose whether to allow or deny - `2`: Allow the request +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ContentAnalysisTelemetry.mdx b/src/content/docs/reference/policies/ContentAnalysisTelemetry.mdx index 2f0310e..d722ddb 100644 --- a/src/content/docs/reference/policies/ContentAnalysisTelemetry.mdx +++ b/src/content/docs/reference/policies/ContentAnalysisTelemetry.mdx @@ -11,10 +11,6 @@ Events are logged with full URLs by default, so this policy is normally used to Values set by this policy are locked, so users cannot change them. -## Examples - - - ## Values - `Enabled`: A Boolean. If `false`, DLP events are not recorded. The default is `true`. @@ -23,6 +19,10 @@ Values set by this policy are locked, so users cannot change them. - `domain`: Log only URL hostnames. - `none`: Do not log URL information. +## Examples + + + ## Compatibility diff --git a/src/content/docs/reference/policies/Cookies.mdx b/src/content/docs/reference/policies/Cookies.mdx index 0c4647b..4004619 100644 --- a/src/content/docs/reference/policies/Cookies.mdx +++ b/src/content/docs/reference/policies/Cookies.mdx @@ -6,10 +6,6 @@ category: "Network security" Configure cookie preferences. -## Examples - - - ## Values - `Allow` is a list of origins (not domains) where cookies are always allowed. You must include `http` or `https`. @@ -32,6 +28,10 @@ Configure cookie preferences. - `RejectTracker` only rejects cookies for trackers. (_Deprecated_. Use `Behavior` instead) - `ExpireAtSessionEnd` determines when cookies expire. (_Deprecated_. Use [`SanitizeOnShutdown`](/reference/policies/sanitizeonshutdown/) instead) +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/CrashReportsSubmit.mdx b/src/content/docs/reference/policies/CrashReportsSubmit.mdx index a4c5690..f4fa752 100644 --- a/src/content/docs/reference/policies/CrashReportsSubmit.mdx +++ b/src/content/docs/reference/policies/CrashReportsSubmit.mdx @@ -6,14 +6,14 @@ category: "Cloud reporting" Configure crash report submission settings. -## Examples - - - ## Values - `Enabled` A Boolean. Controls whether crash reports are automatically submitted or not allowed to be submitted. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DNSOverHTTPS.mdx b/src/content/docs/reference/policies/DNSOverHTTPS.mdx index 6dfb0e0..460f6a1 100644 --- a/src/content/docs/reference/policies/DNSOverHTTPS.mdx +++ b/src/content/docs/reference/policies/DNSOverHTTPS.mdx @@ -9,10 +9,6 @@ Configure [DNS over HTTPS](https://support.mozilla.org/en-US/kb/firefox-dns-over DNS over HTTPS (DoH) sends DNS lookups over an encrypted HTTPS connection to a trusted resolver instead of sending them in plain text to a local resolver. This makes it harder for the network to see or modify lookups, but they no longer go through your DNS infrastructure unless you use a `ProviderURL`. -## Examples - - - ## Values - `Enabled` determines whether DNS over HTTPS is enabled. @@ -29,6 +25,10 @@ This makes it harder for the network to see or modify lookups, but they no longe | `true` | `false` | 3 | Firefox only uses DNS over HTTPS, and a failed lookup is an error. | | `false` | not applicable | 5 | DNS over HTTPS is off. | +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DataLossPrevention.mdx b/src/content/docs/reference/policies/DataLossPrevention.mdx index 4d22bfe..29336ca 100644 --- a/src/content/docs/reference/policies/DataLossPrevention.mdx +++ b/src/content/docs/reference/policies/DataLossPrevention.mdx @@ -13,10 +13,6 @@ Only one DLP service can be active: - If `ContentAnalysis` has `Enabled` set to `true`, the external agent (`ContentAnalysis`) wins and these rules are ignored. - If `ContentAnalysis` is absent, or present without enabling an agent, the built-in `DataLossPrevention` rules apply. -## Examples - - - ## Values - `FallbackResult`: What happens to an operation the engine cannot reach a verdict on, including a request that has timed out. The default is `block`. @@ -35,6 +31,10 @@ Only one DLP service can be active: - `Type`: (**required**) What the rule does when it matches, either `warn` or `block`. - `Message`: Text shown to the user when the rule triggers. +## Examples + + + ## Compatibility diff --git a/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx b/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx index 42b2116..8fa369d 100644 --- a/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx +++ b/src/content/docs/reference/policies/DefaultBrowserSettingEnabled.mdx @@ -11,15 +11,15 @@ When it is set to `true`, the default browser check runs at startup and users ca To suppress the startup check without removing the controls from browser preferences, use the [`DontCheckDefaultBrowser`](/reference/policies/dontcheckdefaultbrowser/) policy instead. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx index 495d664..222aa01 100644 --- a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx @@ -8,10 +8,6 @@ Set the default download directory. You can use `${home}` for the native home directory. -## Examples - - - ## Values `DefaultDownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`. @@ -19,6 +15,10 @@ The user can still change it. - `${home}` expands to the user's home directory, so `${home}/Downloads` works across profiles and platforms. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx b/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx index f4176ad..d1f8baa 100644 --- a/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx +++ b/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx @@ -10,6 +10,11 @@ Control use of the [Web Serial API](https://developer.mozilla.org/en-US/docs/Web > If any enterprise policies are set, the WebSerial API is blocked by default. > To allow usage of the API, set this policy to `3`. +## Values + +- `2` means use of the WebSerial API is blocked. +- `3` means use of the WebSerial API is allowed. + ## Examples ```json @@ -20,11 +25,6 @@ Control use of the [Web Serial API](https://developer.mozilla.org/en-US/docs/Web } ``` -## Values - -- `2` means use of the WebSerial API is blocked. -- `3` means use of the WebSerial API is allowed. - ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableAccounts.mdx b/src/content/docs/reference/policies/DisableAccounts.mdx index a01131f..1223f8c 100644 --- a/src/content/docs/reference/policies/DisableAccounts.mdx +++ b/src/content/docs/reference/policies/DisableAccounts.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Disable account-based services, including sync. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableAppUpdate.mdx b/src/content/docs/reference/policies/DisableAppUpdate.mdx index 2e63d6b..4cc62a8 100644 --- a/src/content/docs/reference/policies/DisableAppUpdate.mdx +++ b/src/content/docs/reference/policies/DisableAppUpdate.mdx @@ -6,15 +6,15 @@ category: "Device update settings" Turn off application updates within Firefox. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx index fec3adf..179ebf0 100644 --- a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx +++ b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx @@ -10,10 +10,6 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally. > Embedded PDF files are shown in the browser. > If you need to completely disable PDF.js, you can use the [`PDFjs`](/reference/policies/pdfjs/) policy. -## Examples - - - ## Values - Set to `true` to hand PDF files to the operating system's default PDF handler. @@ -21,6 +17,10 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally. If the [`Handlers`](/reference/policies/handlers/) policy already configures `application/pdf` or the `pdf` extension, that policy wins and `DisableBuiltinPDFViewer` is ignored. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx index 6777195..7999e2b 100644 --- a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx +++ b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx @@ -10,15 +10,15 @@ Only applicable to Windows; other platforms don't have the agent. The browser agent is a Windows-only scheduled task which runs in the background to collect and submit data about the browser that the user has set as their OS default. More information is available in the [Default Browser Agent](https://firefox-source-docs.mozilla.org/toolkit/mozapps/defaultagent/default-browser-agent/index.html) article. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDeveloperTools.mdx b/src/content/docs/reference/policies/DisableDeveloperTools.mdx index 9112ca5..bbb349a 100644 --- a/src/content/docs/reference/policies/DisableDeveloperTools.mdx +++ b/src/content/docs/reference/policies/DisableDeveloperTools.mdx @@ -6,15 +6,15 @@ category: "Security" Remove access to all developer tools. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx index 81229f4..464901b 100644 --- a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx +++ b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx @@ -7,15 +7,15 @@ category: "Network security" Disable the TLS Feature for [Encrypted Client Hello](https://support.mozilla.org/en-US/kb/understand-encrypted-client-hello). Note that TLS Client Hellos will still contain an ECH extension, but this extension will not be used by Firefox during the TLS handshake. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx index 7921505..4d4cf5d 100644 --- a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx +++ b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx @@ -6,15 +6,15 @@ category: "Browser UI" Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site). -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx index 4854d31..36e9dc8 100644 --- a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx @@ -6,10 +6,6 @@ category: "Miscellaneous" Disable Firefox Accounts integration (Sync). -## Examples - - - ## Values - Set to `true` to disable Firefox accounts and sync. @@ -17,6 +13,10 @@ Disable Firefox Accounts integration (Sync). If [`DisableAccounts`](/reference/policies/disableaccounts/) is also set, it takes precedence and `DisableFirefoxAccounts` is ignored. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx index 3149183..a3d2a87 100644 --- a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Remove access to Firefox Screenshots. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx index 1b47f23..4488f13 100644 --- a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Disable Firefox studies (Shield). -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableForgetButton.mdx b/src/content/docs/reference/policies/DisableForgetButton.mdx index d35e637..8cd56e2 100644 --- a/src/content/docs/reference/policies/DisableForgetButton.mdx +++ b/src/content/docs/reference/policies/DisableForgetButton.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Disable the "Forget" button. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFormHistory.mdx b/src/content/docs/reference/policies/DisableFormHistory.mdx index 6175364..0802888 100644 --- a/src/content/docs/reference/policies/DisableFormHistory.mdx +++ b/src/content/docs/reference/policies/DisableFormHistory.mdx @@ -6,15 +6,15 @@ category: "Local data storage" Turn off saving information on web forms and the search bar. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx b/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx index 0a4f235..9a5da6d 100644 --- a/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx +++ b/src/content/docs/reference/policies/DisableLaunchOnLogin.mdx @@ -9,15 +9,15 @@ Prevent Firefox from launching automatically when the user logs in, and prevent When the policy is set to `true`, Firefox removes any existing launch-on-login entry and hides the **Open Firefox automatically when your computer starts up** checkbox under **Settings > General > Startup**. Setting the policy to `false` has no effect. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx index 38f3c36..12bceb3 100644 --- a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx +++ b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx @@ -10,15 +10,15 @@ If this value is `true`, it works the same as setting [`PrimaryPassword`](/refer If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/reference/policies/primarypassword/) are used, `DisableMasterPasswordCreation` takes precedence. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePasswordReveal.mdx b/src/content/docs/reference/policies/DisablePasswordReveal.mdx index 2c0e3cb..b94b49c 100644 --- a/src/content/docs/reference/policies/DisablePasswordReveal.mdx +++ b/src/content/docs/reference/policies/DisablePasswordReveal.mdx @@ -6,15 +6,15 @@ category: "Password manager" Do not allow passwords to be shown in saved logins. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePocket.mdx b/src/content/docs/reference/policies/DisablePocket.mdx index 8e7a73d..313d3bf 100644 --- a/src/content/docs/reference/policies/DisablePocket.mdx +++ b/src/content/docs/reference/policies/DisablePocket.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Remove Pocket in the Firefox UI. It does not remove it from the new tab page. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx index fb1b73f..e60cfd2 100644 --- a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx +++ b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx @@ -10,15 +10,15 @@ category: "Browsing restrictions" Remove access to private browsing. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileImport.mdx b/src/content/docs/reference/policies/DisableProfileImport.mdx index 0b69922..4e5aae8 100644 --- a/src/content/docs/reference/policies/DisableProfileImport.mdx +++ b/src/content/docs/reference/policies/DisableProfileImport.mdx @@ -6,15 +6,15 @@ category: "Bookmarks" Remove the ability to import data from other browsers. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileRefresh.mdx b/src/content/docs/reference/policies/DisableProfileRefresh.mdx index be41f98..1e1e9cf 100644 --- a/src/content/docs/reference/policies/DisableProfileRefresh.mdx +++ b/src/content/docs/reference/policies/DisableProfileRefresh.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Disable the Refresh Firefox button on `about:support` and `support.mozilla.org`, as well as the prompt that displays offering to refresh Firefox when you haven't used it in a while. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx index cb00c94..907acec 100644 --- a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx +++ b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Prevent Firefox from applying performance, stability, and feature changes between updates. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx b/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx index 8c1e123..00d6aaa 100644 --- a/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx +++ b/src/content/docs/reference/policies/DisableRemoteSettingsAndAcceptSecurityConsequences.mdx @@ -11,15 +11,15 @@ Remote Settings is the mechanism Firefox uses to deliver frequently updated data > [!WARNING] > Turning off Remote Settings stops Firefox from receiving security-critical updates such as the add-on blocklist. Only enable this policy if you fully understand and accept the security consequences. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSafeMode.mdx b/src/content/docs/reference/policies/DisableSafeMode.mdx index 84a2c2a..e6d2710 100644 --- a/src/content/docs/reference/policies/DisableSafeMode.mdx +++ b/src/content/docs/reference/policies/DisableSafeMode.mdx @@ -8,15 +8,15 @@ Disable safe mode ([Troubleshoot Mode](https://support.mozilla.org/en-US/kb/diag On Windows, this disables safe mode via the command line as well. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSecurityBypass.mdx b/src/content/docs/reference/policies/DisableSecurityBypass.mdx index 849639c..739893e 100644 --- a/src/content/docs/reference/policies/DisableSecurityBypass.mdx +++ b/src/content/docs/reference/policies/DisableSecurityBypass.mdx @@ -15,16 +15,16 @@ To change what gets blocked, use [Preferences](/reference/policies/preferences/) If Firefox rejects a certificate that your organization needs to trust, add it with the [`Certificates`](/reference/policies/certificates/) policy instead. -## Examples - - - ## Values - `InvalidCertificate`: Prevents adding an exception when an invalid certificate is shown. - `SafeBrowsing`: Prevents selecting "ignore the risk" and visiting a harmful site anyway. Also hide the **Unblock** button in the Downloads panel for downloads that Safe Browsing has flagged, so a blocked download can only be deleted, not kept. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx index 8070657..f8f596b 100644 --- a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx +++ b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx @@ -6,15 +6,15 @@ category: "Browser UI" Remove the "Set As Desktop Background..." menuitem when right clicking on an image. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx index 994b91b..a510ad6 100644 --- a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx +++ b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx @@ -11,15 +11,15 @@ Because Firefox treats them as part of the browser rather than as user add-ons, If this policy is set to `true`, Firefox does not install new system add-ons or update existing system add-ons through the system add-on update mechanism. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableTelemetry.mdx b/src/content/docs/reference/policies/DisableTelemetry.mdx index 0cd4814..8a001f8 100644 --- a/src/content/docs/reference/policies/DisableTelemetry.mdx +++ b/src/content/docs/reference/policies/DisableTelemetry.mdx @@ -9,15 +9,15 @@ Prevent the upload of telemetry data. Mozilla recommends that you do not disable telemetry. Information collected through telemetry helps us build a better product for businesses like yours. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx index 15fc82b..085060e 100644 --- a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx +++ b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx @@ -8,15 +8,15 @@ Do not allow blocking third-party modules (DLLs) from the `about:third-party` pa This policy only works on Windows through GPO, not via `policies.json`. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisabledCiphers.mdx b/src/content/docs/reference/policies/DisabledCiphers.mdx index dceef1d..c7da945 100644 --- a/src/content/docs/reference/policies/DisabledCiphers.mdx +++ b/src/content/docs/reference/policies/DisabledCiphers.mdx @@ -11,10 +11,6 @@ Disable specific cryptographic ciphers. > Setting a value to `true` disables the cipher, setting a value to `false` enables the cipher. > Previously, setting any value (`true` or `false`) disabled the cipher. -## Examples - - - ## Values The following cryptographic cyphers are configurable as `CIPHER_NAME`: @@ -40,6 +36,10 @@ The following cryptographic cyphers are configurable as `CIPHER_NAME`: - `TLS_AES_128_GCM_SHA256` (Firefox 138, Firefox ESR 128.10) - `TLS_AES_256_GCM_SHA384` (Firefox 138, Firefox ESR 128.10) +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx b/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx index 0fc1bb7..c9a63de 100644 --- a/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx +++ b/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx @@ -6,16 +6,16 @@ category: "Bookmarks" Set the initial state of the bookmarks toolbar. A user can still change how it is displayed. -## Examples - - - ## Values - `always` means the bookmarks toolbar is always shown. - `never` means the bookmarks toolbar is not shown. - `newtab` means the bookmarks toolbar is only shown on the new tab page. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisplayMenuBar.mdx b/src/content/docs/reference/policies/DisplayMenuBar.mdx index 05ddeb7..941af72 100644 --- a/src/content/docs/reference/policies/DisplayMenuBar.mdx +++ b/src/content/docs/reference/policies/DisplayMenuBar.mdx @@ -6,10 +6,6 @@ category: "Browser UI" Set the state of the menubar. -## Examples - - - ## Values - `always` means the menubar is shown and cannot be hidden. @@ -17,6 +13,10 @@ Set the state of the menubar. - `default-on` means the menubar is on by default but can be hidden. - `default-off` means the menubar is off by default but can be shown. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx index 22dfbb3..28e3623 100644 --- a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx +++ b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx @@ -11,15 +11,15 @@ The preference is locked in both cases, so users cannot change whether the check To remove the controls to set Firefox as the default browser, see the [`DefaultBrowserSettingEnabled`](/reference/policies/defaultbrowsersettingenabled/) policy instead. -## Examples - - - ## 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DownloadDirectory.mdx b/src/content/docs/reference/policies/DownloadDirectory.mdx index 0dd3470..9314fd4 100644 --- a/src/content/docs/reference/policies/DownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DownloadDirectory.mdx @@ -7,10 +7,6 @@ category: "Downloads" Set and lock the download directory. You can use `${home}` for the native home directory. -## Examples - - - ## Values `DownloadDirectory` expects a path to the directory downloads are saved to, such as `/Users/username/Documents`. @@ -18,6 +14,10 @@ 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. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/EnableTrackingProtection.mdx b/src/content/docs/reference/policies/EnableTrackingProtection.mdx index 8b36684..8c7b020 100644 --- a/src/content/docs/reference/policies/EnableTrackingProtection.mdx +++ b/src/content/docs/reference/policies/EnableTrackingProtection.mdx @@ -8,10 +8,6 @@ Configure [Enhanced Tracking Protection in Firefox](https://support.mozilla.org/ If this policy is not configured, tracking protection is not enabled by default in the browser, but it is enabled by default in private browsing and the user can change it. -## Examples - - - ## Values - `Value`: a Boolean that enables or disables tracking protection. @@ -34,6 +30,10 @@ If this policy is not configured, tracking protection is not enabled by default > [!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`, `BaselineExceptions` and `ConvenienceExceptions` use their initial values (based on the tracking protection `Category`) unless policy explicitly sets them. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx b/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx index 06e9aa6..60de9d2 100644 --- a/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx +++ b/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx @@ -7,15 +7,15 @@ category: "Content settings" Enable or disable [Encrypted Media Extensions](https://developer.mozilla.org/en-US/docs/Web/API/Encrypted_Media_Extensions_API) (EME) and optionally lock it. EME allows Firefox to play DRM-controlled content using a Content Decryption Module such as [Google Widevine](https://developers.google.com/widevine). -## Examples - - - ## Values - If `Enabled` is set to false, encrypted media extensions (like Widevine) are not downloaded by Firefox unless the user consents to installing them. - If `Locked` is set to true and `Enabled` is set to false, Firefox will not download encrypted media extensions (like Widevine) or ask the user to install them. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx index f150b6d..17a2f18 100644 --- a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx +++ b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx @@ -12,10 +12,6 @@ This policy is based on the [Chrome policy](https://chromeenterprise.google/poli > The `domains` value must be a domain, not a URL pattern. > Additionally, Firefox does not support using a wildcard (`*`) to mean all domains. -## Examples - - - ## Values Each entry in the list accepts the following keys: @@ -24,6 +20,10 @@ Each entry in the list accepts the following keys: - `domains`: A list of domains the exemption applies to, such as `example.com`. These are domains, not URL patterns, and a wildcard (`*`) is not supported. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ExtensionSettings.mdx b/src/content/docs/reference/policies/ExtensionSettings.mdx index ed8de7f..d73c5b3 100644 --- a/src/content/docs/reference/policies/ExtensionSettings.mdx +++ b/src/content/docs/reference/policies/ExtensionSettings.mdx @@ -17,10 +17,6 @@ For locally-installed extensions, go to `about:support` and in the "Add-ons" sec > [!NOTE] > If the extension ID is a UUID (e.g., `{12345678-1234-1234-1234-1234567890ab}`), you must include curly braces around the ID. -## Examples - - - ## Values The configuration for each extension is a dictionary that can contain the fields documented below. @@ -67,6 +63,10 @@ The configuration for each extension is a dictionary that can contain the fields A per-extension `allowed_permissions` carves out exceptions to that extension's own `blocked_permissions`. Setting `allowed_permissions` in the default (`"*"`) configuration has no effect. +## Examples + + + ## Interaction notes - `"installation_mode": "blocked"` takes precedence over all other settings. diff --git a/src/content/docs/reference/policies/ExtensionUpdate.mdx b/src/content/docs/reference/policies/ExtensionUpdate.mdx index df718de..53bbc6c 100644 --- a/src/content/docs/reference/policies/ExtensionUpdate.mdx +++ b/src/content/docs/reference/policies/ExtensionUpdate.mdx @@ -6,15 +6,15 @@ category: "Extensions" Control extension updates. -## Examples - - - ## Values - Set to `true` to leave extension updates enabled. This is the same as not setting the policy. - Set to `false` to stop extensions updating, and prevent the user from turning updates back on. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Extensions.mdx b/src/content/docs/reference/policies/Extensions.mdx index 657283b..ea21b3b 100644 --- a/src/content/docs/reference/policies/Extensions.mdx +++ b/src/content/docs/reference/policies/Extensions.mdx @@ -12,16 +12,16 @@ Control the installation, uninstallation and locking of extensions. > It does not support native paths, so you'll have to use `file://` URLs. > Before using `Extensions`, it's recommended to use `ExtensionSettings` as all future improvements will be applied to that policy instead. -## Examples - - - ## Values - `Install` is a list of URLs or native paths for extensions to be installed. - `Uninstall` is a list of extension IDs that should be uninstalled if found. - `Locked` is a list of extension IDs that the user cannot disable or uninstall. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/FirefoxHome.mdx b/src/content/docs/reference/policies/FirefoxHome.mdx index 397e808..f7f04ec 100644 --- a/src/content/docs/reference/policies/FirefoxHome.mdx +++ b/src/content/docs/reference/policies/FirefoxHome.mdx @@ -6,10 +6,6 @@ category: "Startup" Customize the Firefox Home page. -## Examples - - - ## Values Each key named after a Firefox Home section is a Boolean that shows or hides that section, and `Locked` prevents the user from changing any of them. @@ -23,6 +19,10 @@ Each key named after a Firefox Home section is a Boolean that shows or hides tha The ids are `clocks`, `crossword`, `focusTimer`, `lists`, `pictureOfTheDay`, `privacy`, `recentSearches`, `sportsWidget`, `stocks`, and `weather`. An invalid widget id is ignored. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/FirefoxSuggest.mdx b/src/content/docs/reference/policies/FirefoxSuggest.mdx index 5502830..bb0f382 100644 --- a/src/content/docs/reference/policies/FirefoxSuggest.mdx +++ b/src/content/docs/reference/policies/FirefoxSuggest.mdx @@ -7,10 +7,6 @@ category: "Search" Customize Firefox Suggest (US only). As of Firefox 146, `WebSuggestions` turns off Suggest completely. -## Examples - - - ## Values - `WebSuggestions`: Set to `false` to turn off Firefox Suggest. @@ -21,6 +17,10 @@ As of Firefox 146, `WebSuggestions` turns off Suggest completely. Values are applied as defaults that users can change, unless `Locked` is set to `true`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/GenerativeAI.mdx b/src/content/docs/reference/policies/GenerativeAI.mdx index 2dab33c..42ddbfa 100644 --- a/src/content/docs/reference/policies/GenerativeAI.mdx +++ b/src/content/docs/reference/policies/GenerativeAI.mdx @@ -6,10 +6,6 @@ category: "Miscellaneous" Configure generative AI features. -## Examples - - - ## Values - `Enabled` Controls whether generative AI features are enabled by default. @@ -23,6 +19,10 @@ Configure generative AI features. If false, AI is not used to suggest names or tabs for tab groups. - `Locked` Prevents the user from changing generative AI preferences. +## Examples + + + ## Windows (GPO) ```url diff --git a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx index 07a9198..9ef14ac 100644 --- a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx +++ b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx @@ -6,15 +6,15 @@ category: "Network security" Whether to always go through the DNS server before sending a single word search string to a search engine. -## Examples - - - ## Values - Set to `true` to send a single word entry to the DNS server before the search engine, and lock the setting. - Set to `false` to send a single word entry straight to the search engine, and lock the setting. +## Examples + + + ## Description If the site exists, it will navigate to the website. diff --git a/src/content/docs/reference/policies/Handlers.mdx b/src/content/docs/reference/policies/Handlers.mdx index 1f95270..bd32d25 100644 --- a/src/content/docs/reference/policies/Handlers.mdx +++ b/src/content/docs/reference/policies/Handlers.mdx @@ -9,10 +9,6 @@ This policy is based on the internal format of `handlers.json`. You can configure handlers based on a [mime type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/MIME_types) (`mimeTypes`), a file's extension (`extensions`), or a [protocol](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Schemes) (`schemes`). -## Examples - - - ## Values Within each handler type, you specify the given mimeType/extension/scheme as a key and use the following subkeys to describe how it is handled. @@ -26,6 +22,10 @@ Within each handler type, you specify the given mimeType/extension/scheme as a k |  `path` | The native path to the executable to be used. | |  `uriTemplate` | A url to a web based application handler. The URL must be https and contain a %s to be used for substitution. | +## Examples + + + ## Windows (GPO) Software\Policies\Mozilla\Firefox\Handlers (REG_MULTI_SZ) = diff --git a/src/content/docs/reference/policies/HardwareAcceleration.mdx b/src/content/docs/reference/policies/HardwareAcceleration.mdx index 4b34d5b..623b57b 100644 --- a/src/content/docs/reference/policies/HardwareAcceleration.mdx +++ b/src/content/docs/reference/policies/HardwareAcceleration.mdx @@ -6,15 +6,15 @@ category: "Miscellaneous" Control hardware acceleration. -## Examples - - - ## Values - Set to `true` to leave hardware acceleration enabled. This is the same as not setting the policy. - Set to `false` to disable hardware acceleration, and prevent the user from turning it back on. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Homepage.mdx b/src/content/docs/reference/policies/Homepage.mdx index f43de20..738c706 100644 --- a/src/content/docs/reference/policies/Homepage.mdx +++ b/src/content/docs/reference/policies/Homepage.mdx @@ -9,10 +9,6 @@ Configure the default homepage and how Firefox starts. This policy covers startup and the Home button. It does not change what a new tab shows: use the [`NewTabPage`](/reference/policies/newtabpage/) policy to turn the New Tab page off, or the [`FirefoxHome`](/reference/policies/firefoxhome/) policy to change the sections on it. -## Examples - - - ## Values The following members are configurable: @@ -31,6 +27,10 @@ The following members are configurable: > [!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`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/HttpAllowlist.mdx b/src/content/docs/reference/policies/HttpAllowlist.mdx index 462babe..b83dbcb 100644 --- a/src/content/docs/reference/policies/HttpAllowlist.mdx +++ b/src/content/docs/reference/policies/HttpAllowlist.mdx @@ -7,16 +7,16 @@ category: "Network security" Configure sites that will not be upgraded to HTTPS. The sites are specified as a list of origins. -## Examples - - - ## Values `HttpAllowlist` expects a list of origins that are not upgraded to HTTPS, such as `http://example.org`. Each entry is a scheme, hostname and optional port. Paths and wildcards are not supported. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/HttpsOnlyMode.mdx b/src/content/docs/reference/policies/HttpsOnlyMode.mdx index ade7045..baeabbc 100644 --- a/src/content/docs/reference/policies/HttpsOnlyMode.mdx +++ b/src/content/docs/reference/policies/HttpsOnlyMode.mdx @@ -9,10 +9,6 @@ Configure [HTTPS-Only Mode](https://support.mozilla.org/en-US/kb/https-only-pref In HTTPS-Only Mode, Firefox attempts to upgrade HTTP connections to HTTPS and shows a warning page when a site is only available over HTTP. To exempt specific sites from the upgrade, use the [`HttpAllowlist`](/reference/policies/httpallowlist/) policy. -## Examples - - - ## Values | Value | Description | @@ -22,6 +18,10 @@ To exempt specific sites from the upgrade, use the [`HttpAllowlist`](/reference/ | enabled | HTTPS-Only Mode is on by default, but the user can turn it off. | | force_enabled | HTTPS-Only Mode is on and the user can't turn it off. | +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/IPProtectionAvailable.mdx b/src/content/docs/reference/policies/IPProtectionAvailable.mdx index 99b908d..7766567 100644 --- a/src/content/docs/reference/policies/IPProtectionAvailable.mdx +++ b/src/content/docs/reference/policies/IPProtectionAvailable.mdx @@ -6,15 +6,15 @@ category: "Network security" Prevent the built-in VPN from being available to users. -## Examples - - - ## Values - Set to `true` to leave the built-in VPN available. This is the same as not setting the policy. - Set to `false` to make the built-in VPN unavailable to users. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/InstallAddonsPermission.mdx b/src/content/docs/reference/policies/InstallAddonsPermission.mdx index 177abb4..453abde 100644 --- a/src/content/docs/reference/policies/InstallAddonsPermission.mdx +++ b/src/content/docs/reference/policies/InstallAddonsPermission.mdx @@ -6,15 +6,15 @@ category: "Extensions" Configure the default extension install policy as well as origins for extension installs are allowed. This policy does not override turning off all extension installs. -## Examples - - - ## Values - `Allow` is a list of origins where extension installs are allowed. - `Default` determines whether or not extension installs are allowed by default. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacyProfiles.mdx b/src/content/docs/reference/policies/LegacyProfiles.mdx index 5dcb5b3..2de59a1 100644 --- a/src/content/docs/reference/policies/LegacyProfiles.mdx +++ b/src/content/docs/reference/policies/LegacyProfiles.mdx @@ -12,6 +12,11 @@ If this policy set to `false`, Firefox will create a new profile for each unique This policy only work on Windows via GPO (not via `policies.json`). +## Values + +- Set to `true` to share one profile across every installation, the same as the `MOZ_LEGACY_PROFILES` environment variable. +- Set to `false` to create a separate profile for each installation. This is the same as not setting the policy. + ## Examples ```json @@ -22,11 +27,6 @@ This policy only work on Windows via GPO (not via `policies.json`). } ``` -## Values - -- Set to `true` to share one profile across every installation, the same as the `MOZ_LEGACY_PROFILES` environment variable. -- Set to `false` to create a separate profile for each installation. This is the same as not setting the policy. - ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx index 75649b8..c0eeca4 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx @@ -8,10 +8,6 @@ Enable default legacy SameSite cookie behavior setting. If this policy is set to true, it reverts all cookies to legacy SameSite behavior which means that cookies that don't explicitly specify a [`SameSite` attribute](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#samesitesamesite-value) are treated as if they were `SameSite=None`. -## Examples - - - ## Values - Set to `true` to treat cookies with no `SameSite` attribute as `SameSite=None`. @@ -19,6 +15,10 @@ If this policy is set to true, it reverts all cookies to legacy SameSite behavio The policy sets the default behavior rather than locking it, so a user can still change it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx index ef90565..0ff6707 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx @@ -8,10 +8,6 @@ Revert to legacy SameSite behavior for cookies on specified sites. If this policy is set to true, cookies set for domains in this list will revert to legacy SameSite behavior which means that cookies that don't explicitly specify a [`SameSite` attribute](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie#samesitesamesite-value) are treated as if they were `SameSite=None`. -## Examples - - - ## Values `LegacySameSiteCookieBehaviorEnabledForDomainList` expects a list of domains, such as `example.org`. @@ -19,6 +15,10 @@ Cookies set for those domains revert to legacy `SameSite` behavior. The policy sets the default behavior rather than locking it, so a user can still change it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LocalFileLinks.mdx b/src/content/docs/reference/policies/LocalFileLinks.mdx index f9726b8..59bdcf3 100644 --- a/src/content/docs/reference/policies/LocalFileLinks.mdx +++ b/src/content/docs/reference/policies/LocalFileLinks.mdx @@ -12,15 +12,15 @@ Firefox blocks the navigation and reports a security error in the browser consol This policy lists the origins that are allowed to link to the local file system. Intranet applications may need this, for example, to link to files on a shared drive. -## Examples - - - ## Values `LocalFileLinks` expects a list of origins allowed to link to `file:///` URLs, such as `http://example.org/`. Each origin is a scheme, hostname and optional port. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LocalNetworkAccess.mdx b/src/content/docs/reference/policies/LocalNetworkAccess.mdx index a3c0087..990c0a0 100644 --- a/src/content/docs/reference/policies/LocalNetworkAccess.mdx +++ b/src/content/docs/reference/policies/LocalNetworkAccess.mdx @@ -11,10 +11,6 @@ Without these checks, websites can send requests to devices such as routers, pri This can be dangerous because some devices assume that requests originating from the local network are trusted, which can enable attacks such as [cross-site request forgery](https://developer.mozilla.org/en-US/docs/Web/Security/Attacks/CSRF). Local network access protections require permission before a website can make requests to local or loopback addresses, where applicable. -## Examples - - - ## Values - `Enabled`: a Boolean that enables or disables the policy. @@ -36,6 +32,10 @@ Local network access protections require permission before a website can make re > Setting `Enabled` to `false` turns both permission prompting and blocking third-party trackers off. > `SkipDomains` is applied independently, whether or not `Enabled` is defined. +## Examples + + + ## Description When providing a list of exceptions for trusted domains, the `SkipDomains` array can contain both **source domains** (the website making the request) and **target domains** (the local resource being accessed). diff --git a/src/content/docs/reference/policies/ManagedBookmarks.mdx b/src/content/docs/reference/policies/ManagedBookmarks.mdx index 7751c32..2098212 100644 --- a/src/content/docs/reference/policies/ManagedBookmarks.mdx +++ b/src/content/docs/reference/policies/ManagedBookmarks.mdx @@ -10,10 +10,6 @@ The bookmarks are only added as a button on the personal toolbar, they are not i The syntax of this policy is based on the [Chrome ManagedBookmarks policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ManagedBookmarks), with the addition of the Firefox-specific `favicon` property. -## Examples - - - ## Values The first entry in the list names the toolbar folder, and the entries after it are the bookmarks: @@ -28,6 +24,10 @@ The first entry in the list names the toolbar folder, and the entries after it a - `children`: A list of bookmarks to put in a folder. Folders can be nested. +## Examples + + + ## Windows (GPO) Software\Policies\Mozilla\Firefox\ManagedBookmarks (REG_MULTI_SZ) = diff --git a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx index 44e2e8a..06ce202 100644 --- a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx +++ b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx @@ -15,15 +15,15 @@ If this policy is enabled: This policy is primarily intended for advanced end users, not for enterprises, but it is available via GPO. -## Examples - - - ## Values - Set to `true` to switch to manual updates only. - Set to `false` to leave automatic update checking enabled. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx index f7597df..48ac299 100644 --- a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx +++ b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx @@ -10,15 +10,15 @@ If this policy is set to `true`, Firefox will use credentials stored in the Comp For the Windows equivalent, see the [`WindowsSSO`](/reference/policies/windowssso/) policy, which signs in to Microsoft, work, and school accounts using credentials stored in Windows. -## Examples - - - ## Values - Set to `true` to enable single sign-on for Microsoft Entra accounts, and lock the setting. - Set to `false` to disable single sign-on for Microsoft Entra accounts, and lock the setting. +## Examples + + + ## macOS ```xml diff --git a/src/content/docs/reference/policies/NetworkPrediction.mdx b/src/content/docs/reference/policies/NetworkPrediction.mdx index 3e42ada..14d4ed1 100644 --- a/src/content/docs/reference/policies/NetworkPrediction.mdx +++ b/src/content/docs/reference/policies/NetworkPrediction.mdx @@ -6,15 +6,15 @@ category: "Network security" Enable or disable network prediction ([DNS prefetching](https://developer.mozilla.org/en-US/docs/Glossary/Prefetch#dns_prefetching)). -## Examples - - - ## Values - Set to `true` to allow DNS prefetching, and lock the setting. - Set to `false` to stop DNS prefetching, over both HTTP and HTTPS, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NewTabPage.mdx b/src/content/docs/reference/policies/NewTabPage.mdx index fa11b1a..6b4180f 100644 --- a/src/content/docs/reference/policies/NewTabPage.mdx +++ b/src/content/docs/reference/policies/NewTabPage.mdx @@ -12,15 +12,15 @@ This policy only covers new tabs. To configure what Firefox opens at startup, and what the Home button loads, see the [`Homepage`](/reference/policies/homepage/) policy. To keep the New Tab page but change which sections appear on it, use the [`FirefoxHome`](/reference/policies/firefoxhome/) policy. -## Examples - - - ## Values - Set to `true` to open Firefox Home on new tabs, and lock the setting. - Set to `false` to open a blank page on new tabs, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx index e492af7..a98fe6a 100644 --- a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx +++ b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx @@ -8,15 +8,15 @@ Disable the creation of default bookmarks. This policy is only effective if the user profile has not been created yet. -## Examples - - - ## Values - Set to `true` to stop Firefox creating the default bookmarks. - Set to `false` to create the default bookmarks. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLogins.mdx b/src/content/docs/reference/policies/OfferToSaveLogins.mdx index ec2c54d..5b91289 100644 --- a/src/content/docs/reference/policies/OfferToSaveLogins.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLogins.mdx @@ -6,15 +6,15 @@ category: "Password manager" Control whether or not Firefox offers to save passwords. -## Examples - - - ## Values - Set to `true` to offer to save logins and passwords, and prevent the user from changing it. - Set to `false` to stop offering to save logins and passwords, and prevent the user from changing it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx index 714e4fa..7a89361 100644 --- a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx @@ -6,10 +6,6 @@ category: "Password manager" Sets the default value of `signon.rememberSignons` without locking it. -## Examples - - - ## Values - Set to `true` to offer to save logins and passwords by default. The user can still change it. @@ -17,6 +13,10 @@ Sets the default value of `signon.rememberSignons` without locking it. If [`OfferToSaveLogins`](/reference/policies/offertosavelogins/) is also set, it takes precedence and `OfferToSaveLoginsDefault` is ignored. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx index 6d1a709..6d1b582 100644 --- a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx +++ b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx @@ -13,10 +13,6 @@ Starting with Firefox 83, Firefox ESR 78.5, you can also specify multiple URLs s For the page shown after Firefox updates, see the [`OverridePostUpdatePage`](/reference/policies/overridepostupdatepage/) policy. -## Examples - - - ## Values `OverrideFirstRunPage` expects the URL to show the first time a new profile is used: @@ -25,6 +21,10 @@ For the page shown after Firefox updates, see the [`OverridePostUpdatePage`](/re Multiple URLs can be separated by a vertical bar (`|`), each opening in its own tab. - An empty string (`""`) shows no first run page at all. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx index 3569bcd..de8dd88 100644 --- a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx +++ b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx @@ -12,10 +12,6 @@ Setting this policy replaces that page and stops Firefox from using a page suppl For the page shown the first time a new profile is used, see the [`OverrideFirstRunPage`](/reference/policies/overridefirstrunpage/) policy. -## Examples - - - ## Values `OverridePostUpdatePage` expects the URL to show the first time Firefox starts after an update: @@ -23,6 +19,10 @@ For the page shown the first time a new profile is used, see the [`OverrideFirst - A URL, such as `https://example.com`, replaces the What's New page with that page. - An empty string (`""`) shows no page after an update. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PDFjs.mdx b/src/content/docs/reference/policies/PDFjs.mdx index e3f589e..bd1069a 100644 --- a/src/content/docs/reference/policies/PDFjs.mdx +++ b/src/content/docs/reference/policies/PDFjs.mdx @@ -10,15 +10,15 @@ Disable or configure PDF.js, the built-in PDF viewer. > DisableBuiltinPDFViewer has not been deprecated. You can either continue to use it, or switch to using `PDFjs->Enabled` to disable the built-in PDF viewer. > This new permission was added because we needed a place for `PDFjs->EnabledPermissions`. -## Examples - - - ## Values - If `Enabled` is set to `false`, the built-in PDF viewer is disabled. - If `EnablePermissions` is set to `true`, the built-in PDF viewer will honor document permissions like preventing the copying of text. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx index 71375c1..5715284 100644 --- a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx +++ b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx @@ -6,15 +6,15 @@ category: "Password manager" Remove access to the password manager via preferences and block `about:logins`. -## Examples - - - ## Values - Set to `true` to keep the password manager available and offer to save logins, and lock the setting. - Set to `false` to block `about:logins`, remove password management from settings, and stop Firefox saving logins. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx index dd764a9..d0a53e4 100644 --- a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx +++ b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx @@ -8,16 +8,16 @@ Prevent Firefox from saving passwords for specific sites. The sites are specified as a list of origins. -## Examples - - - ## Values `PasswordManagerExceptions` expects a list of origins Firefox never offers to save passwords for, such as `https://example.org`. Each origin is a scheme, hostname and optional port. Paths and wildcards are not supported. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Permissions.mdx b/src/content/docs/reference/policies/Permissions.mdx index cf745b8..65b383c 100644 --- a/src/content/docs/reference/policies/Permissions.mdx +++ b/src/content/docs/reference/policies/Permissions.mdx @@ -8,10 +8,6 @@ Set permissions associated with camera, microphone, location, notifications, aut Because these are [origins](https://developer.mozilla.org/en-US/docs/Glossary/Origin), not domains, entries with unique ports must be specified separately. This explicitly means that it is not possible to add wildcards. See examples below. -## Examples - - - ## Values - `Allow` is a list of origins where the feature is allowed. @@ -20,6 +16,10 @@ This explicitly means that it is not possible to add wildcards. See examples bel - `Locked` prevents the user from changing preferences for the feature. - `Default` specifies the default value for Autoplay. block-audio-video is not supported on Firefox ESR 68. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PictureInPicture.mdx b/src/content/docs/reference/policies/PictureInPicture.mdx index 6f61482..7df3070 100644 --- a/src/content/docs/reference/policies/PictureInPicture.mdx +++ b/src/content/docs/reference/policies/PictureInPicture.mdx @@ -6,10 +6,6 @@ category: "Content settings" Enable or disable [Picture-in-Picture](https://support.mozilla.org/en-US/kb/about-picture-picture-firefox) as well as prevent the user from enabling or disabling it (`Locked`). -## Examples - - - ## Values - `Enabled`: Set to `true` to make the Picture-in-Picture toggle available, or `false` to remove it. @@ -17,6 +13,10 @@ Enable or disable [Picture-in-Picture](https://support.mozilla.org/en-US/kb/abou `Enabled` is applied as a default that users can change, unless `Locked` is set to `true`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PopupBlocking.mdx b/src/content/docs/reference/policies/PopupBlocking.mdx index 92e384f..ed906ae 100644 --- a/src/content/docs/reference/policies/PopupBlocking.mdx +++ b/src/content/docs/reference/policies/PopupBlocking.mdx @@ -7,16 +7,16 @@ category: "Content settings" Allow certain websites to display popups and be [redirected by third-party frames](https://support.mozilla.org/en-US/kb/pop-blocker-settings-exceptions-troubleshooting). Third-party redirect blocking is an extension of the pop-up blocker, so the same origins and settings apply to both. -## Examples - - - ## Values - `Allow` is a list of origins where popup-windows and third-party redirects are allowed. - `Default` determines whether or not pop-up windows and third-party redirects are allowed by default. - `Locked` prevents the user from changing pop-up windows and third-party redirects preferences. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx index f6ee839..7011cc2 100644 --- a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx +++ b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx @@ -16,15 +16,15 @@ The policy covers TLS, HTTP/3 as of Firefox 128, and WebRTC. Setting this policy locks the preferences, whether the value is `true` or `false`, so users cannot change them. This policy is independent of [`CNSA2KeyAgreementEnabled`](/reference/policies/cnsa2keyagreementenabled/): setting it to `false` does not stop Firefox from offering ML-KEM-1024 if that policy is enabled. -## Examples - - - ## Values - Set to `true` to enable post-quantum key agreement for TLS, HTTP/3 and WebRTC, and lock the settings. - Set to `false` to disable post-quantum key agreement for TLS, HTTP/3 and WebRTC, and lock the settings. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Preferences.mdx b/src/content/docs/reference/policies/Preferences.mdx index 613ac51..3e7aef8 100644 --- a/src/content/docs/reference/policies/Preferences.mdx +++ b/src/content/docs/reference/policies/Preferences.mdx @@ -17,10 +17,6 @@ You can also set default preferences, user preferences and you can clear prefere > There are too many preferences to provide comprehensive documentation here. > The source file [StaticPrefList.yaml](https://searchfox.org/mozilla-central/source/modules/libpref/init/StaticPrefList.yaml) contains information about most of them. -## Examples - - - ## Values Preferences that start with the following prefixes are supported: @@ -119,6 +115,10 @@ See the examples below for more detail. > [!WARNING] > Make sure you're only setting a particular preference using this mechanism and not some other way. +## Examples + + + ## Windows (GPO) Software\Policies\Mozilla\Firefox\Preferences (REG_MULTI_SZ) = diff --git a/src/content/docs/reference/policies/PrimaryPassword.mdx b/src/content/docs/reference/policies/PrimaryPassword.mdx index 564d9d6..943a9cc 100644 --- a/src/content/docs/reference/policies/PrimaryPassword.mdx +++ b/src/content/docs/reference/policies/PrimaryPassword.mdx @@ -11,15 +11,15 @@ If this value is false, it works the same as if [`DisableMasterPasswordCreation` If both `DisableMasterPasswordCreation` and `PrimaryPassword` are used, `DisableMasterPasswordCreation` takes precedence. -## Examples - - - ## Values - Set to `true` to require a primary password, and stop the user removing it. - Set to `false` to remove primary password functionality, the same as setting [`DisableMasterPasswordCreation`](/reference/policies/disablemasterpasswordcreation/) to `true`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrintingEnabled.mdx b/src/content/docs/reference/policies/PrintingEnabled.mdx index 2b7f3da..3e50299 100644 --- a/src/content/docs/reference/policies/PrintingEnabled.mdx +++ b/src/content/docs/reference/policies/PrintingEnabled.mdx @@ -6,15 +6,15 @@ category: "Printing" Enable or disable printing. -## Examples - - - ## Values - Set to `true` to allow printing, and lock the setting. - Set to `false` to disable printing, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx index fd252f0..3517f3c 100644 --- a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx +++ b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx @@ -8,10 +8,6 @@ Set availability of private browsing mode. This policy supersedes [`DisablePrivateBrowsing`](/reference/policies/disableprivatebrowsing/) -## Examples - - - ## Values `PrivateBrowsingModeAvailability` expects one of the following number values: @@ -20,6 +16,10 @@ This policy supersedes [`DisablePrivateBrowsing`](/reference/policies/disablepri - `1`: Private Browsing mode not available - `2`: Private Browsing mode is forced +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx index 9fd5f0f..3e0fc57 100644 --- a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx +++ b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx @@ -6,15 +6,15 @@ category: "Downloads" Ask where to save each file before downloading. -## Examples - - - ## Values - Set to `true` to ask where to save each file, and lock the setting. - Set to `false` to save files to the download directory without asking, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Proxy.mdx b/src/content/docs/reference/policies/Proxy.mdx index 0e18124..d735db9 100644 --- a/src/content/docs/reference/policies/Proxy.mdx +++ b/src/content/docs/reference/policies/Proxy.mdx @@ -13,10 +13,6 @@ Unless you lock this policy, changes the user already has in place will take eff > [!NOTE] > In the Windows ADMX templates, these settings were moved to their own category to make them easier to configure via Intune. -## Examples - - - ## Values - `Mode` is the proxy method being used. @@ -32,6 +28,10 @@ Unless you lock this policy, changes the user already has in place will take eff - `AutoLogin` means do not prompt for authentication if password is saved. - `UseProxyForDNS` to use proxy DNS when using SOCKS v5. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/RelaunchRequired.mdx b/src/content/docs/reference/policies/RelaunchRequired.mdx index 45cf773..f585db0 100644 --- a/src/content/docs/reference/policies/RelaunchRequired.mdx +++ b/src/content/docs/reference/policies/RelaunchRequired.mdx @@ -7,10 +7,6 @@ category: "Device update settings" Require Firefox to be relaunched within a given period and notify the user of the upcoming relaunch. This policy takes effect when an update has been downloaded or staged and is ready to install. -## Examples - - - ## Values - `NotificationPeriodHours`: The minimum number of hours before users are notified of the required relaunch. @@ -19,6 +15,10 @@ This policy takes effect when an update has been downloaded or staged and is rea - `Hour`: The hour in 24-hour format (between `0` and `23`). - `Minute`: The minute (between `0` and `59`). +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/RequestedLocales.mdx b/src/content/docs/reference/policies/RequestedLocales.mdx index a3b6ea3..601d17a 100644 --- a/src/content/docs/reference/policies/RequestedLocales.mdx +++ b/src/content/docs/reference/policies/RequestedLocales.mdx @@ -7,10 +7,6 @@ category: "Miscellaneous" Set the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active. -## Examples - - - ## Values `RequestedLocales` accepts either an array of locale codes or a comma-separated string, in order of preference: @@ -21,6 +17,10 @@ It will cause the corresponding language pack to become active. The first locale with an available language pack becomes active. The policy is applied when its value changes, so a user who switches language afterwards is not switched back. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMax.mdx b/src/content/docs/reference/policies/SSLVersionMax.mdx index 84fbdcb..b3825af 100644 --- a/src/content/docs/reference/policies/SSLVersionMax.mdx +++ b/src/content/docs/reference/policies/SSLVersionMax.mdx @@ -13,10 +13,6 @@ For setting and locking the minimum version of TLS, see the [`SSLVersionMin`](/r > TLS 1.0 and TLS 1.1 are deprecated. > It's not recommended to set a maximum of `tls1` or `tls1.1`, which stops Firefox from using TLS 1.2 and above. -## Examples - - - ## Values `SSLVersionMax` expects one of the following values: @@ -26,6 +22,10 @@ For setting and locking the minimum version of TLS, see the [`SSLVersionMin`](/r - `tls1.2`: TLS 1.2 - `tls1.3`: TLS 1.3 +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMin.mdx b/src/content/docs/reference/policies/SSLVersionMin.mdx index 26557a3..71f7853 100644 --- a/src/content/docs/reference/policies/SSLVersionMin.mdx +++ b/src/content/docs/reference/policies/SSLVersionMin.mdx @@ -13,10 +13,6 @@ For setting and locking the maximum version of TLS, see the [`SSLVersionMax`](/r > TLS 1.0 and TLS 1.1 are deprecated, meaning it's not recommended to enable anything lower than TLS 1.2. > Setting a minimum of `tls1` or `tls1.1` re-enables them for every site, and the cipher suites those versions rely on may also need to be turned back on with the `security.tls.version.enable-deprecated` preference. -## Examples - - - ## Values `SSLVersionMin` expects one of the following values: @@ -26,6 +22,10 @@ For setting and locking the maximum version of TLS, see the [`SSLVersionMax`](/r - `tls1.2`: TLS 1.2 - `tls1.3`: TLS 1.3 +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx index 35d0ca4..4a92ae1 100644 --- a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx +++ b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx @@ -12,10 +12,6 @@ Items that can be selectively deleted include browsing & download history, cooki > Starting with Firefox 158, [`ClearOnShutdown`](/reference/policies/clearonshutdown/) supersedes this policy. > When both are set, `SanitizeOnShutdown` is ignored entirely. -## Examples - - - ## Values `SanitizeOnShutdown` accepts either a boolean or an object. @@ -38,6 +34,10 @@ Accepts one or more of the following members to clear specific data types: - `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`. +## Examples + + + ## Windows (GPO) Clear all data: diff --git a/src/content/docs/reference/policies/SearchBar.mdx b/src/content/docs/reference/policies/SearchBar.mdx index 7e3d4bb..363b08b 100644 --- a/src/content/docs/reference/policies/SearchBar.mdx +++ b/src/content/docs/reference/policies/SearchBar.mdx @@ -6,10 +6,6 @@ category: "Search" Set whether or not the [search bar](https://support.mozilla.org/en-US/kb/add-search-bar-firefox-toolbar) is displayed. -## Examples - - - ## Values `SearchBar` expects one of the following values: @@ -19,6 +15,10 @@ Set whether or not the [search bar](https://support.mozilla.org/en-US/kb/add-sea The policy sets the placement rather than forcing it, so a user who moves the search bar afterwards is not moved back. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SearchEngines.mdx b/src/content/docs/reference/policies/SearchEngines.mdx index 38ab862..7078581 100644 --- a/src/content/docs/reference/policies/SearchEngines.mdx +++ b/src/content/docs/reference/policies/SearchEngines.mdx @@ -6,10 +6,6 @@ category: "Search" Configure search engines in Firefox. As of Firefox 139, these policies are available in all Firefox release channels. -## Examples - - - ## Values `SearchEngines` accepts an object with one or more of the following keys: @@ -29,6 +25,10 @@ Configure search engines in Firefox. As of Firefox 139, these policies are avail - `PreventInstalls` (boolean): prevent installing search engines from webpages. - `Remove` (array of strings): hide built-in search engines by name. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx index 890180a..17b4f60 100644 --- a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx +++ b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx @@ -12,15 +12,15 @@ The `SearchSuggestEnabled` policy covers both the address bar and the separate s For the Firefox Suggest results that come from Mozilla rather than from the search engine, use the [`FirefoxSuggest`](/reference/policies/firefoxsuggest/) policy. -## Examples - - - ## Values - Set to `true` to show search suggestions in the address bar and search bar, and lock the setting. - Set to `false` to hide search suggestions, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SecurityDevices.mdx b/src/content/docs/reference/policies/SecurityDevices.mdx index c37b73e..82b7f03 100644 --- a/src/content/docs/reference/policies/SecurityDevices.mdx +++ b/src/content/docs/reference/policies/SecurityDevices.mdx @@ -9,10 +9,6 @@ Add or delete [PKCS #11 modules](https://en.wikipedia.org/wiki/PKCS_11). A PKCS #11 module is an external library that lets Firefox talk to a cryptographic device such as a smart card or hardware token, so that certificates and keys on that device can be used for client authentication. The `SecurityDevices` policy loads those libraries instead of requiring the user to manage them manually from the Security Devices dialog in Settings. -## Examples - - - ## Values - `Add` maps a device name to the full path of the module library on disk. @@ -20,6 +16,10 @@ The `SecurityDevices` policy loads those libraries instead of requiring the user - `Delete` is a list of device names to unload, using the name the module was added under. Removing a name that is not loaded is not an error. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SecurityLogging.mdx b/src/content/docs/reference/policies/SecurityLogging.mdx index 4f5c5f6..15bf3e5 100644 --- a/src/content/docs/reference/policies/SecurityLogging.mdx +++ b/src/content/docs/reference/policies/SecurityLogging.mdx @@ -11,10 +11,6 @@ When an event is logged, Firefox records it and submits it in the `enterprise` t Values set by this policy are locked, so users cannot change them. -## Examples - - - ## Values Each key configures one event. @@ -43,6 +39,10 @@ All keys accept the following sub-keys: - `metadata`: Log only file extensions and MIME types. - `none`: Do not log file information. +## Examples + + + ## Compatibility diff --git a/src/content/docs/reference/policies/ShowHomeButton.mdx b/src/content/docs/reference/policies/ShowHomeButton.mdx index ac640c6..12c934b 100644 --- a/src/content/docs/reference/policies/ShowHomeButton.mdx +++ b/src/content/docs/reference/policies/ShowHomeButton.mdx @@ -8,15 +8,15 @@ Show the home button on the toolbar. Future versions of Firefox will not show the home button by default. -## Examples - - - ## Values - Set to `true` to add the home button to the toolbar, and stop it being removed by default. - Set to `false` to remove the home button from the toolbar. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SignOut.mdx b/src/content/docs/reference/policies/SignOut.mdx index 030c33c..9ccb604 100644 --- a/src/content/docs/reference/policies/SignOut.mdx +++ b/src/content/docs/reference/policies/SignOut.mdx @@ -9,10 +9,6 @@ Configure sign-out behavior for enterprise users. By default, shutting the browser down signs the session out, so the next launch requires the user to sign in again. Set this policy to lock the session on shutdown instead, so that returning users only need to unlock it. -## Examples - - - ## Values - `Shutdown`: Controls what happens to the session when the browser shuts down. @@ -21,6 +17,10 @@ Set this policy to lock the session on shutdown instead, so that returning users - `signout`: Sign the session out, so the next launch requires a full sign-in. This is what happens when the policy is not set. +## Examples + + + ## Compatibility diff --git a/src/content/docs/reference/policies/SitePolicies.mdx b/src/content/docs/reference/policies/SitePolicies.mdx index 14bf24e..ce75774 100644 --- a/src/content/docs/reference/policies/SitePolicies.mdx +++ b/src/content/docs/reference/policies/SitePolicies.mdx @@ -8,6 +8,48 @@ Fine grained control over policies for specific sites. Admins can use `SitePolicies` to apply policies to individual sites rather than the whole browser, for example turning [the JIT engine](https://developer.mozilla.org/en-US/docs/Glossary/Just_In_Time_Compilation) off on untrusted sites, disallowing HTTP downgrades, or isolating sites in their own [container](https://support.mozilla.org/en-US/kb/how-use-firefox-containers). +## Values + +The policy is made up of a list of rules that are evaluated in order. +Each rule can contain: + +- `Match`: a list of sites. + An empty list or missing property means to match all sites. +- `Exceptions`: a list of sites which when matched bypasses this set of rules. +- `Policies`: an object defining the site policies. + +> [!NOTE] +> A "site" refers to a registerable domain, so `*.example.com` is a valid site but `*.com` is not. + +Currently the supported site policies are: + +- `DisableJit` disables the JIT engine for the site when `true`. + + > [!WARNING] + > When the JIT engine is disabled, some sites may be slow, experience breakages, and WebAssembly won't be executed. + > Be sure to scope `DisableJit` as narrowly as possible using `Match` patterns, or via exemptions using `Exceptions`. + +- `HttpsOnly` stops the site from being loaded over plain HTTP when `true`. + When it is `false`, HTTP is explicitly allowed for the site, which is how you carve a site out of a broader rule. + +- `DisableServiceWorkers` stops the site from registering or using [service workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) when `true`. + Only `http` and `https` sites are affected, and sites relying on service workers for offline support or push notifications will lose those features. + +- `Container` loads the site in a dedicated container, keeping its cookies, storage, and logins separate from the rest of the browser. + Setting `Container` in a rule turns container support on and locks it, so the user cannot switch it off. (Firefox 158) \ + Accepts the following values: + - `id`: (**required**) A non-empty identifier you choose for the container. Every rule that uses the same `id` shares one container. + - `ephemeral`: An optional boolean. When `true`, the container's data is cleared after its last tab closes, and at shutdown. Defaults to `false`. + + Navigating to a matching site loads it in a new tab inside the container. + These containers are not listed in the containers UI, they have no colored tab indicator, and the user cannot pick them from the container menu. + When a container is no longer named by any rule, Firefox deletes it along with its data. + + > [!NOTE] + > `ephemeral` controls when a container's data is deleted, not whether it is written to disk. + > If Firefox crashes instead of shutting down normally, data may be left behind. + > At the next startup, Firefox clears the data of ephemeral containers that are no longer named by a rule, but container that is still named by a rule keeps its data until its last tab closes again or Firefox next shuts down normally. + ## Examples @@ -55,48 +97,6 @@ This setting loads `*.example.com` in a container whose data is cleared once its ] ``` -## Values - -The policy is made up of a list of rules that are evaluated in order. -Each rule can contain: - -- `Match`: a list of sites. - An empty list or missing property means to match all sites. -- `Exceptions`: a list of sites which when matched bypasses this set of rules. -- `Policies`: an object defining the site policies. - -> [!NOTE] -> A "site" refers to a registerable domain, so `*.example.com` is a valid site but `*.com` is not. - -Currently the supported site policies are: - -- `DisableJit` disables the JIT engine for the site when `true`. - - > [!WARNING] - > When the JIT engine is disabled, some sites may be slow, experience breakages, and WebAssembly won't be executed. - > Be sure to scope `DisableJit` as narrowly as possible using `Match` patterns, or via exemptions using `Exceptions`. - -- `HttpsOnly` stops the site from being loaded over plain HTTP when `true`. - When it is `false`, HTTP is explicitly allowed for the site, which is how you carve a site out of a broader rule. - -- `DisableServiceWorkers` stops the site from registering or using [service workers](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API) when `true`. - Only `http` and `https` sites are affected, and sites relying on service workers for offline support or push notifications will lose those features. - -- `Container` loads the site in a dedicated container, keeping its cookies, storage, and logins separate from the rest of the browser. - Setting `Container` in a rule turns container support on and locks it, so the user cannot switch it off. (Firefox 158) \ - Accepts the following values: - - `id`: (**required**) A non-empty identifier you choose for the container. Every rule that uses the same `id` shares one container. - - `ephemeral`: An optional boolean. When `true`, the container's data is cleared after its last tab closes, and at shutdown. Defaults to `false`. - - Navigating to a matching site loads it in a new tab inside the container. - These containers are not listed in the containers UI, they have no colored tab indicator, and the user cannot pick them from the container menu. - When a container is no longer named by any rule, Firefox deletes it along with its data. - - > [!NOTE] - > `ephemeral` controls when a container's data is deleted, not whether it is written to disk. - > If Firefox crashes instead of shutting down normally, data may be left behind. - > At the next startup, Firefox clears the data of ephemeral containers that are no longer named by a rule, but container that is still named by a rule keeps its data until its last tab closes again or Firefox next shuts down normally. - ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SkipTermsOfUse.mdx b/src/content/docs/reference/policies/SkipTermsOfUse.mdx index 4c500d8..b3b66b4 100644 --- a/src/content/docs/reference/policies/SkipTermsOfUse.mdx +++ b/src/content/docs/reference/policies/SkipTermsOfUse.mdx @@ -9,15 +9,15 @@ Configure display settings for the Firefox Terms of Use and Privacy Notice on st If `true`, don't display the Firefox [Terms of Use](https://www.mozilla.org/about/legal/terms/firefox/) and [Privacy Notice](https://www.mozilla.org/privacy/firefox/) upon startup. You represent that you accept and have the authority to accept the Terms of Use on behalf of all individuals to whom you provide access to this browser. -## Examples - - - ## Values - Set to `true` to skip the Terms of Use and Privacy Notice on startup, accepting them on behalf of your users. - Set to `false` to show the Terms of Use and Privacy Notice. This is the same as not setting the policy. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx index 9419156..f09e646 100644 --- a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx +++ b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx @@ -6,15 +6,15 @@ category: "Downloads" Force downloads to start off in a local, temporary location rather than the default download directory. -## Examples - - - ## Values - Set to `true` to download files to a temporary directory before moving them, and lock the setting. - Set to `false` to download files straight to the download directory, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SupportMenu.mdx b/src/content/docs/reference/policies/SupportMenu.mdx index a02bba5..946453b 100644 --- a/src/content/docs/reference/policies/SupportMenu.mdx +++ b/src/content/docs/reference/policies/SupportMenu.mdx @@ -9,16 +9,16 @@ Add a menuitem to the help menu for specifying support information. The item is added to the bottom of the Help menu, below a separator, so your own support contact sits alongside the built-in Firefox help entries. Selecting it opens the URL you specify in a new tab. -## Examples - - - ## Values - `Title`: a string label shown in the Help menu. - `URL`: a string with the URL that opens when the item is selected. - `AccessKey` (optional): a single character used as the keyboard shortcut for the item within the menu. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx index fc29f05..32ab4a4 100644 --- a/src/content/docs/reference/policies/Sync.mdx +++ b/src/content/docs/reference/policies/Sync.mdx @@ -6,10 +6,6 @@ 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. -## Examples - - - ## Values - `Addons`: A Boolean. Controls whether syncing addons should be enabled. @@ -25,6 +21,10 @@ Controls whether [sync](https://www.firefox.com/en-US/features/sync/) should be If `Locked` is `true`, the Sync data type settings are locked so users cannot change them, and `Enabled` connects or disconnects sync. Users can no longer turn sync on or off themselves, whether `Enabled` is `true` or `false`, and only a policy update can change it. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/TranslateEnabled.mdx b/src/content/docs/reference/policies/TranslateEnabled.mdx index 046927b..1bda669 100644 --- a/src/content/docs/reference/policies/TranslateEnabled.mdx +++ b/src/content/docs/reference/policies/TranslateEnabled.mdx @@ -10,10 +10,6 @@ Enable or disable webpage translation. If you only want to disable the popup, you can set the `browser.translations.automaticallyPopup` preference to `false` using the [Preferences](/reference/policies/preferences/) policy. -## Examples - - - ## Values - Set to `true` to enable webpage translation, and lock the setting. @@ -21,6 +17,10 @@ If you only want to disable the popup, you can set the `browser.translations.aut If [`AIControls`](/reference/policies/aicontrols/) sets `Translations` or `Default`, it takes precedence and `TranslateEnabled` is ignored. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx index 42baea0..1a87ca6 100644 --- a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx +++ b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx @@ -9,15 +9,15 @@ Use the system print dialog instead of the print preview window. Firefox normally opens its own [print dialog](https://support.mozilla.org/en-US/kb/how-print-web-pages-firefox), which combines the print preview and the print settings in a single panel. If this policy is set to `true`, Firefox skips that panel and opens the operating system print dialog directly, skipping the preview. -## Examples - - - ## Values - Set to `true` to print using the operating system print dialog instead of the Firefox print preview, and lock the setting. - Set to `false` to print using the Firefox print preview, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/UserMessaging.mdx b/src/content/docs/reference/policies/UserMessaging.mdx index 524475c..6cbc7ee 100644 --- a/src/content/docs/reference/policies/UserMessaging.mdx +++ b/src/content/docs/reference/policies/UserMessaging.mdx @@ -11,10 +11,6 @@ This policy turns those off individually, which is usually needed when users are Each message-specific key covers one type of message, so setting one does not affect the others. -## Examples - - - ## Values - `WhatsNew`: Remove the "What's New" icon and menuitem. (_Deprecated_) @@ -27,6 +23,10 @@ Each message-specific key covers one type of message, so setting one does not af - `FirefoxLabs`: If `false`, don't show the "Firefox Labs" section in Preferences. (Firefox 130.0.1) - `Locked`: Prevents the user from changing user messaging preferences. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/VisualSearchEnabled.mdx b/src/content/docs/reference/policies/VisualSearchEnabled.mdx index 12da88d..79e0b5c 100644 --- a/src/content/docs/reference/policies/VisualSearchEnabled.mdx +++ b/src/content/docs/reference/policies/VisualSearchEnabled.mdx @@ -9,15 +9,15 @@ Enable or disable visual search. Visual search lets users search the web using an image on the page instead of typing a query, through [Google Lens](https://support.mozilla.org/en-US/kb/search-web-images-firefox-google-lens) in the context menu. It is only offered when Google is the default search engine, so removing Google with the [`SearchEngines`](/reference/policies/searchengines/) policy also takes the feature away. -## Examples - - - ## Values - Set to `true` to enable visual search, and lock the setting. - Set to `false` to disable visual search, and lock the setting. +## Examples + + + ## Windows (GPO) ```url diff --git a/src/content/docs/reference/policies/Watermark.mdx b/src/content/docs/reference/policies/Watermark.mdx index 665cd2c..c3b4ec0 100644 --- a/src/content/docs/reference/policies/Watermark.mdx +++ b/src/content/docs/reference/policies/Watermark.mdx @@ -9,10 +9,6 @@ Display a textual watermark over a configurable list of websites for traceabilit The watermark is drawn over every matching page, including when a page is opened in Reader Mode or View Source. By default it shows the signed-in user's email address with a timestamp below it, which makes screenshots of internal sites traceable. -## Examples - - - ## Values - `Match`: (**required**) A list of URL match patterns for the pages to watermark. @@ -29,6 +25,10 @@ By default it shows the signed-in user's email address with a timestamp below it - `Angle`: The rotation of the text in degrees. Defaults to `-45`. - `Size`: The size of a single watermark tile, in CSS pixels. Defaults to `300` and is clamped between `100` and `2048`. +## Examples + + + ## Compatibility diff --git a/src/content/docs/reference/policies/WebsiteFilter.mdx b/src/content/docs/reference/policies/WebsiteFilter.mdx index d90f73c..fce78dc 100644 --- a/src/content/docs/reference/policies/WebsiteFilter.mdx +++ b/src/content/docs/reference/policies/WebsiteFilter.mdx @@ -6,10 +6,6 @@ category: "Browsing restrictions" Block websites from being visited. -## Examples - - - ## Values `WebsiteFilter` expects an array of Match Patterns, as described in https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns. @@ -19,6 +15,10 @@ The arrays are limited to 1000 entries each. A single wildcard (`*`) as a value is not sufficient. - For specific [protocols](https://developer.mozilla.org/en-US/docs/Web/URI/Reference/Schemes#protocol), use `https://*/*` or `http://*/*`. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/WindowsSSO.mdx b/src/content/docs/reference/policies/WindowsSSO.mdx index ec65a56..10b264c 100644 --- a/src/content/docs/reference/policies/WindowsSSO.mdx +++ b/src/content/docs/reference/policies/WindowsSSO.mdx @@ -8,15 +8,15 @@ Allow Windows single sign-on for Microsoft, work, and school accounts. If this policy is set to `true`, Firefox will use credentials stored in Windows to sign in to Microsoft, work, and school accounts. -## Examples - - - ## Values - Set to `true` to allow Windows single sign-on for Microsoft, work and school accounts, and lock the setting. - Set to `false` to stop Windows single sign-on, and lock the setting. +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/XSLTEnabled.mdx b/src/content/docs/reference/policies/XSLTEnabled.mdx index b77a188..1aa1832 100644 --- a/src/content/docs/reference/policies/XSLTEnabled.mdx +++ b/src/content/docs/reference/policies/XSLTEnabled.mdx @@ -6,15 +6,15 @@ category: "Content settings" Enable or disable support for the [XSLTProcessor](https://developer.mozilla.org/en-US/docs/Web/API/XSLTProcessor) JavaScript API and the [XSLT processing instruction](https://developer.mozilla.org/en-US/docs/Web/XML/XSLT/Reference/Element/processing-instruction). -## Examples - - - ## Values - Set to `true` to allow XSLT processing, and lock the setting. - Set to `false` to block XSLT processing, and lock the setting. +## Examples + + + ## Windows (GPO) ```