From 283074bb19bac746783c3d4af5ce9025369537a0 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 15 Jun 2026 14:35:59 +0200 Subject: [PATCH 1/3] feat: Add examples sourced from schema --- CONTRIBUTING.md | 2 +- README.md | 20 ++++++++++++++++++ src/components/PolicyExample.astro | 21 +++++++++++++++++++ .../docs/reference/policies/3rdparty.mdx | 6 ++++++ .../docs/reference/policies/AIChatbot.mdx | 6 ++++++ .../docs/reference/policies/AIControls.mdx | 6 ++++++ .../reference/policies/AccessConnector.mdx | 6 ++++++ .../policies/AllowFileSelectionDialogs.mdx | 6 ++++++ .../policies/AllowedDomainsForApps.mdx | 6 ++++++ .../docs/reference/policies/AppAutoUpdate.mdx | 6 ++++++ .../docs/reference/policies/AppUpdatePin.mdx | 6 ++++++ .../docs/reference/policies/AppUpdateURL.mdx | 6 ++++++ .../reference/policies/Authentication.mdx | 6 ++++++ .../AutoLaunchProtocolsFromOrigins.mdx | 6 ++++++ .../policies/AutofillAddressEnabled.mdx | 6 ++++++ .../policies/AutofillCreditCardEnabled.mdx | 6 ++++++ .../policies/BackgroundAppUpdate.mdx | 6 ++++++ .../reference/policies/BlockAboutAddons.mdx | 6 ++++++ .../reference/policies/BlockAboutConfig.mdx | 6 ++++++ .../reference/policies/BlockAboutProfiles.mdx | 6 ++++++ .../reference/policies/BlockAboutSupport.mdx | 6 ++++++ .../docs/reference/policies/Bookmarks.mdx | 6 ++++++ .../reference/policies/BrowserDataBackup.mdx | 6 ++++++ .../docs/reference/policies/CaptivePortal.mdx | 6 ++++++ .../docs/reference/policies/Certificates.mdx | 6 ++++++ .../docs/reference/policies/Containers.mdx | 6 ++++++ .../reference/policies/ContentAnalysis.mdx | 6 ++++++ .../docs/reference/policies/Cookies.mdx | 6 ++++++ .../reference/policies/CrashReportsSubmit.mdx | 6 ++++++ .../docs/reference/policies/DNSOverHTTPS.mdx | 6 ++++++ .../policies/DefaultDownloadDirectory.mdx | 6 ++++++ .../policies/DefaultSerialGuardSetting.mdx | 2 +- .../reference/policies/DisableAccounts.mdx | 6 ++++++ .../reference/policies/DisableAppUpdate.mdx | 6 ++++++ .../policies/DisableBuiltinPDFViewer.mdx | 6 ++++++ .../policies/DisableDefaultBrowserAgent.mdx | 6 ++++++ .../policies/DisableDeveloperTools.mdx | 6 ++++++ .../policies/DisableEncryptedClientHello.mdx | 6 ++++++ .../policies/DisableFeedbackCommands.mdx | 6 ++++++ .../policies/DisableFirefoxAccounts.mdx | 6 ++++++ .../policies/DisableFirefoxScreenshots.mdx | 6 ++++++ .../policies/DisableFirefoxStudies.mdx | 6 ++++++ .../policies/DisableForgetButton.mdx | 6 ++++++ .../reference/policies/DisableFormHistory.mdx | 6 ++++++ .../DisableMasterPasswordCreation.mdx | 6 ++++++ .../policies/DisablePasswordReveal.mdx | 6 ++++++ .../docs/reference/policies/DisablePocket.mdx | 6 ++++++ .../policies/DisablePrivateBrowsing.mdx | 6 ++++++ .../policies/DisableProfileImport.mdx | 6 ++++++ .../policies/DisableProfileRefresh.mdx | 6 ++++++ .../policies/DisableRemoteImprovements.mdx | 6 ++++++ .../reference/policies/DisableSafeMode.mdx | 6 ++++++ .../policies/DisableSecurityBypass.mdx | 6 ++++++ .../policies/DisableSetDesktopBackground.mdx | 6 ++++++ .../policies/DisableSystemAddonUpdate.mdx | 6 ++++++ .../reference/policies/DisableTelemetry.mdx | 6 ++++++ .../reference/policies/DisabledCiphers.mdx | 6 ++++++ .../policies/DisplayBookmarksToolbar.mdx | 6 ++++++ .../reference/policies/DisplayMenuBar.mdx | 6 ++++++ .../policies/DontCheckDefaultBrowser.mdx | 6 ++++++ .../policies/EnableTrackingProtection.mdx | 6 ++++++ .../policies/EncryptedMediaExtensions.mdx | 6 ++++++ ...eTypePairsFromFileTypeDownloadWarnings.mdx | 6 ++++++ .../reference/policies/ExtensionSettings.mdx | 6 ++++++ .../reference/policies/ExtensionUpdate.mdx | 6 ++++++ .../docs/reference/policies/Extensions.mdx | 6 ++++++ .../docs/reference/policies/FirefoxHome.mdx | 6 ++++++ .../reference/policies/FirefoxSuggest.mdx | 6 ++++++ .../docs/reference/policies/GenerativeAI.mdx | 6 ++++++ ...anetSiteForSingleWordEntryInAddressBar.mdx | 6 ++++++ .../docs/reference/policies/Handlers.mdx | 6 ++++++ .../policies/HardwareAcceleration.mdx | 6 ++++++ .../docs/reference/policies/Homepage.mdx | 6 ++++++ .../docs/reference/policies/HttpAllowlist.mdx | 6 ++++++ .../docs/reference/policies/HttpsOnlyMode.mdx | 6 ++++++ .../policies/IPProtectionAvailable.mdx | 6 ++++++ .../policies/InstallAddonsPermission.mdx | 6 ++++++ .../LegacySameSiteCookieBehaviorEnabled.mdx | 6 ++++++ ...SiteCookieBehaviorEnabledForDomainList.mdx | 6 ++++++ .../reference/policies/LocalFileLinks.mdx | 6 ++++++ .../reference/policies/LocalNetworkAccess.mdx | 6 ++++++ .../reference/policies/ManagedBookmarks.mdx | 6 ++++++ .../policies/ManualAppUpdateOnly.mdx | 6 ++++++ .../reference/policies/MicrosoftEntraSSO.mdx | 6 ++++++ .../reference/policies/NetworkPrediction.mdx | 6 ++++++ .../docs/reference/policies/NewTabPage.mdx | 6 ++++++ .../reference/policies/NoDefaultBookmarks.mdx | 6 ++++++ .../reference/policies/OfferToSaveLogins.mdx | 6 ++++++ .../policies/OfferToSaveLoginsDefault.mdx | 6 ++++++ .../policies/OverrideFirstRunPage.mdx | 6 ++++++ .../policies/OverridePostUpdatePage.mdx | 6 ++++++ src/content/docs/reference/policies/PDFjs.mdx | 6 ++++++ .../policies/PasswordManagerEnabled.mdx | 6 ++++++ .../policies/PasswordManagerExceptions.mdx | 6 ++++++ .../docs/reference/policies/Permissions.mdx | 6 ++++++ .../reference/policies/PictureInPicture.mdx | 6 ++++++ .../docs/reference/policies/PopupBlocking.mdx | 6 ++++++ .../PostQuantumKeyAgreementEnabled.mdx | 6 ++++++ .../docs/reference/policies/Preferences.mdx | 6 ++++++ .../reference/policies/PrimaryPassword.mdx | 6 ++++++ .../reference/policies/PrintingEnabled.mdx | 6 ++++++ .../PrivateBrowsingModeAvailability.mdx | 6 ++++++ .../policies/PromptForDownloadLocation.mdx | 6 ++++++ src/content/docs/reference/policies/Proxy.mdx | 6 ++++++ .../reference/policies/RelaunchRequired.mdx | 6 ++++++ .../reference/policies/RequestedLocales.mdx | 6 ++++++ .../docs/reference/policies/SSLVersionMax.mdx | 6 ++++++ .../docs/reference/policies/SSLVersionMin.mdx | 6 ++++++ .../reference/policies/SanitizeOnShutdown.mdx | 6 ++++++ .../docs/reference/policies/SearchBar.mdx | 6 ++++++ .../docs/reference/policies/SearchEngines.mdx | 6 ++++++ .../policies/SearchSuggestEnabled.mdx | 6 ++++++ .../reference/policies/SecurityDevices.mdx | 6 ++++++ .../reference/policies/ShowHomeButton.mdx | 6 ++++++ .../docs/reference/policies/SitePolicies.mdx | 6 ++++++ .../reference/policies/SkipTermsOfUse.mdx | 6 ++++++ .../StartDownloadsInTempDirectory.mdx | 6 ++++++ .../docs/reference/policies/SupportMenu.mdx | 6 ++++++ src/content/docs/reference/policies/Sync.mdx | 6 ++++++ .../reference/policies/TranslateEnabled.mdx | 6 ++++++ .../policies/UseSystemPrintDialog.mdx | 6 ++++++ .../docs/reference/policies/UserMessaging.mdx | 6 ++++++ .../policies/VisualSearchEnabled.mdx | 6 ++++++ .../docs/reference/policies/WebsiteFilter.mdx | 6 ++++++ .../docs/reference/policies/WindowsSSO.mdx | 6 ++++++ .../docs/reference/policies/XSLTEnabled.mdx | 6 ++++++ 126 files changed, 775 insertions(+), 2 deletions(-) create mode 100644 src/components/PolicyExample.astro diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 7089004..c7dcb0b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,7 @@ Use the following sections per release and omit any that don't apply: - `### Fixed`: bug fixes, or corrections to documentation - `### Removed`: removed policies or deprecated functionality -### Example +### Examples The following entry is for Firefox release version 119: diff --git a/README.md b/README.md index b39f879..5b8c80c 100644 --- a/README.md +++ b/README.md @@ -61,6 +61,26 @@ See my example: ``` +### Policy examples + +Each reference page shows a copy & paste-ready JSON example under `## Examples`. +The examples come from the upstream policy schema, which is fetched to `schema/policies-schema.json`. +This can be refreshed from upstream using `npm run schema:sync`. + +To add the example to a policy page, import the `PolicyExample` component and pass the policy name as `policy="policy-name"`: + +```mdx +--- +title: "Some page" +--- + +import PolicyExample from "../../../../components/PolicyExample.astro"; + +## Examples + + +``` + ## Starlight documentation See [Starlight's docs](https://starlight.astro.build/), or read [the Astro documentation](https://docs.astro.build). diff --git a/src/components/PolicyExample.astro b/src/components/PolicyExample.astro new file mode 100644 index 0000000..d144d4e --- /dev/null +++ b/src/components/PolicyExample.astro @@ -0,0 +1,21 @@ +--- +import { Code } from "@astrojs/starlight/components"; +import schema from "../../schema/policies-schema.json"; + +interface Props { + /** Match a key under `properties` in policies-schema.json. */ + policy: string; +} + +const { policy } = Astro.props; + +const entry = (schema.properties as Record)[policy]; +const examples = Array.isArray(entry?.examples) ? entry.examples : []; + +// Wrap each in `{ policies: { policyname:`, so it's copy-paste ready. +const blocks = examples.map((example) => + JSON.stringify({ policies: { [policy]: example } }, null, 2), +); +--- + +{blocks.map((code) => )} diff --git a/src/content/docs/reference/policies/3rdparty.mdx b/src/content/docs/reference/policies/3rdparty.mdx index e85373b..319ddff 100644 --- a/src/content/docs/reference/policies/3rdparty.mdx +++ b/src/content/docs/reference/policies/3rdparty.mdx @@ -4,6 +4,8 @@ description: "Allow WebExtensions to configure policy." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -12,6 +14,10 @@ For GPO and Intune, the extension developer should provide an ADMX file. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## macOS ```xml diff --git a/src/content/docs/reference/policies/AIChatbot.mdx b/src/content/docs/reference/policies/AIChatbot.mdx index b742f15..bc1ea82 100644 --- a/src/content/docs/reference/policies/AIChatbot.mdx +++ b/src/content/docs/reference/policies/AIChatbot.mdx @@ -4,6 +4,8 @@ description: "Configure the AI chatbot sidebar." category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -14,6 +16,10 @@ For more information, see [Access AI chatbots in Firefox](https://support.mozill **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.chat.provider`, `browser.ml.chat.providers`, `browser.ml.chat.shortcuts`, `browser.ml.chat.prompts.0`, `browser.ml.chat.prompts.1`, `browser.ml.chat.prompts.2`, `browser.ml.chat.prompts.3` +## Examples + + + ## Values - `Providers`: Configures the available AI chatbot providers. diff --git a/src/content/docs/reference/policies/AIControls.mdx b/src/content/docs/reference/policies/AIControls.mdx index 99efd3f..d83d348 100644 --- a/src/content/docs/reference/policies/AIControls.mdx +++ b/src/content/docs/reference/policies/AIControls.mdx @@ -4,6 +4,8 @@ description: "Configure AI controls." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -11,6 +13,10 @@ For more information, see [Block generative AI features with Firefox AI controls **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.chat.page`, `browser.ai.control.sidebarChatbot`, `browser.translations.enable`, `browser.ai.control.translations`, `pdfjs.enableAltText`, `browser.ai.control.pdfjsAltText`, `browser.ml.linkPreview.enabled`, `browser.ai.control.linkPreviewKeyPoints`, `browser.tabs.groups.smart.userEnabled`, `browser.ai.control.smartTabGroups`, `browser.ai.control.smartWindow` +## Examples + + + ## Values Each key controls the availability of a specific AI feature. diff --git a/src/content/docs/reference/policies/AccessConnector.mdx b/src/content/docs/reference/policies/AccessConnector.mdx index 8d1e5b3..84e3581 100644 --- a/src/content/docs/reference/policies/AccessConnector.mdx +++ b/src/content/docs/reference/policies/AccessConnector.mdx @@ -4,6 +4,8 @@ description: "Configure an Access Connector for proxying web traffic." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure an Access Connector for proxying web traffic. When this policy is set, Firefox traffic matching the specified URL patterns is routed through the configured proxy. @@ -14,6 +16,10 @@ When this policy is set, Firefox traffic matching the specified URL patterns is **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values - `Host`: A string that defines the hostname or IP address of the proxy server to use. diff --git a/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx b/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx index ff629ff..53a1523 100644 --- a/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx +++ b/src/content/docs/reference/policies/AllowFileSelectionDialogs.mdx @@ -4,12 +4,18 @@ description: "Enable or disable file selection dialogs." category: "Browser UI" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable file selection dialogs. **Compatibility:** Firefox 124\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `widget.disable_file_pickers` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AllowedDomainsForApps.mdx b/src/content/docs/reference/policies/AllowedDomainsForApps.mdx index 22e5668..9718f93 100644 --- a/src/content/docs/reference/policies/AllowedDomainsForApps.mdx +++ b/src/content/docs/reference/policies/AllowedDomainsForApps.mdx @@ -4,6 +4,8 @@ description: "Define domains allowed to access Google Workspace." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -12,6 +14,10 @@ If this policy is enabled, users can only access Google Workspace using accounts **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppAutoUpdate.mdx b/src/content/docs/reference/policies/AppAutoUpdate.mdx index 7c99e71..4f70766 100644 --- a/src/content/docs/reference/policies/AppAutoUpdate.mdx +++ b/src/content/docs/reference/policies/AppAutoUpdate.mdx @@ -4,6 +4,8 @@ description: "Enable or disable **automatic** application update." category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable **automatic** application update. If set to `true`, application updates are installed without user approval within Firefox. The operating system might still require approval. @@ -16,6 +18,10 @@ If you have disabled updates via [`DisableAppUpdate`](/reference/policies/disabl **CCK2 Equivalent:** N/A\ **Preferences Affected:** `app.update.auto` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppUpdatePin.mdx b/src/content/docs/reference/policies/AppUpdatePin.mdx index 45a8d60..fc36f0e 100644 --- a/src/content/docs/reference/policies/AppUpdatePin.mdx +++ b/src/content/docs/reference/policies/AppUpdatePin.mdx @@ -4,6 +4,8 @@ description: "Prevent Firefox from being updated beyond the specified version." category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent Firefox from being updated beyond the specified pinned version. The format for versioning is [semver](https://semver.org/), which uses `MAJOR.MINOR.PATCH` format. @@ -22,6 +24,10 @@ If you specify a version that doesn't exist, Firefox will update beyond that ver **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AppUpdateURL.mdx b/src/content/docs/reference/policies/AppUpdateURL.mdx index a9cec90..ee7c9f3 100644 --- a/src/content/docs/reference/policies/AppUpdateURL.mdx +++ b/src/content/docs/reference/policies/AppUpdateURL.mdx @@ -4,12 +4,18 @@ description: "Change the URL for application update if you are providing Firefox category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Change the URL for application update if you are providing Firefox updates from a custom update server. **Compatibility:** Firefox 62, Firefox ESR 60.2\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `app.update.url` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Authentication.mdx b/src/content/docs/reference/policies/Authentication.mdx index 79df715..dc4a323 100644 --- a/src/content/docs/reference/policies/Authentication.mdx +++ b/src/content/docs/reference/policies/Authentication.mdx @@ -4,6 +4,8 @@ description: "Configure sites that support integrated authentication." category: "Authentication" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -13,6 +15,10 @@ The `PrivateBrowsing` member enables integrated authentication in private browsi **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.negotiate-auth.trusted-uris`,`network.negotiate-auth.delegation-uris`,`network.automatic-ntlm-auth.trusted-uris`,`network.automatic-ntlm-auth.allow-non-fqdn`,`network.negotiate-auth.allow-non-fqdn`,`network.automatic-ntlm-auth.allow-proxies`,`network.negotiate-auth.allow-proxies`,`network.auth.private-browsing-sso` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx index 13624ca..9b02b3d 100644 --- a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx +++ b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx @@ -4,6 +4,8 @@ description: "Define a list of external protocols that can be used from listed o category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Define a list of external protocols that can be used from listed origins without prompting the user. The origin is the scheme plus the hostname. The syntax of this policy is exactly the same as the [Chrome AutoLaunchProtocolsFromOrigins policy](https://chromeenterprise.google/policies/#AutoLaunchProtocolsFromOrigins) except that you can only use valid origins (not just hostnames). @@ -36,6 +38,10 @@ The schema is: **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutofillAddressEnabled.mdx b/src/content/docs/reference/policies/AutofillAddressEnabled.mdx index 64ce7bc..82d53a7 100644 --- a/src/content/docs/reference/policies/AutofillAddressEnabled.mdx +++ b/src/content/docs/reference/policies/AutofillAddressEnabled.mdx @@ -4,6 +4,8 @@ description: "Enables or disables autofill for addresses." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enables or disables autofill for addresses. This only applies when address autofill is enabled for a particular Firefox version or region. @@ -13,6 +15,10 @@ See [Automatically fill in your address on web forms](https://support.mozilla.or **CCK2 Equivalent:** N/A\ **Preferences Affected:** `extensions.formautofill.addresses.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx b/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx index d6d42b3..1305515 100644 --- a/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx +++ b/src/content/docs/reference/policies/AutofillCreditCardEnabled.mdx @@ -4,6 +4,8 @@ description: "Enables or disables autofill for payment methods." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -12,6 +14,10 @@ This only applies when payment method autofill is enabled for a particular Firef **CCK2 Equivalent:** N/A\ **Preferences Affected:** `extensions.formautofill.creditCards.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx index 2bb4b8c..5fb1ca9 100644 --- a/src/content/docs/reference/policies/BackgroundAppUpdate.mdx +++ b/src/content/docs/reference/policies/BackgroundAppUpdate.mdx @@ -4,6 +4,8 @@ description: "Enable or disable automatic application update in the background, category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable automatic application update **in the background**, when the application is not running. If set to `true`, application updates may be installed (without explicit user approval) in the background, even when the application is not running. @@ -20,6 +22,10 @@ If you are having trouble getting the background task to run, verify your config **CCK2 Equivalent:** N/A\ **Preferences Affected:** `app.update.background.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutAddons.mdx b/src/content/docs/reference/policies/BlockAboutAddons.mdx index f94c07b..b8e7a3d 100644 --- a/src/content/docs/reference/policies/BlockAboutAddons.mdx +++ b/src/content/docs/reference/policies/BlockAboutAddons.mdx @@ -4,12 +4,18 @@ description: "Block access to the Add-ons Manager ('about:addons')." category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Block access to the Add-ons Manager (`about:addons`). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableAddonsManager`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutConfig.mdx b/src/content/docs/reference/policies/BlockAboutConfig.mdx index a842094..d1edb09 100644 --- a/src/content/docs/reference/policies/BlockAboutConfig.mdx +++ b/src/content/docs/reference/policies/BlockAboutConfig.mdx @@ -4,12 +4,18 @@ description: "Block access to 'about:config'." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Block access to `about:config`. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableAboutConfig`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutProfiles.mdx b/src/content/docs/reference/policies/BlockAboutProfiles.mdx index c8a1958..841056f 100644 --- a/src/content/docs/reference/policies/BlockAboutProfiles.mdx +++ b/src/content/docs/reference/policies/BlockAboutProfiles.mdx @@ -4,12 +4,18 @@ description: "Block access to About Profiles ('about:profiles')." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Block access to About Profiles (`about:profiles`). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableAboutProfiles`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BlockAboutSupport.mdx b/src/content/docs/reference/policies/BlockAboutSupport.mdx index 64cd573..c57ed75 100644 --- a/src/content/docs/reference/policies/BlockAboutSupport.mdx +++ b/src/content/docs/reference/policies/BlockAboutSupport.mdx @@ -4,12 +4,18 @@ description: "Block access to Troubleshooting Information ('about:support')." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Block access to Troubleshooting Information (`about:support`). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableAboutSupport`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Bookmarks.mdx b/src/content/docs/reference/policies/Bookmarks.mdx index 75abf66..6e6b88e 100644 --- a/src/content/docs/reference/policies/Bookmarks.mdx +++ b/src/content/docs/reference/policies/Bookmarks.mdx @@ -4,6 +4,8 @@ description: "Add bookmarks in either the bookmarks toolbar or menu. Use 'Manage category: "Bookmarks" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + > [!WARNING] > The [`ManagedBookmarks`](/reference/policies/managedbookmarks/) policy is the recommended way to add bookmarks. > The `Bookmarks` policy will continue to be supported for backwards-compatibility purposes. @@ -16,6 +18,10 @@ If you want to clear all bookmarks set with this policy, you can set the value t **CCK2 Equivalent:** `bookmarks.toolbar`,`bookmarks.menu`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/BrowserDataBackup.mdx b/src/content/docs/reference/policies/BrowserDataBackup.mdx index f626e02..8b060ac 100644 --- a/src/content/docs/reference/policies/BrowserDataBackup.mdx +++ b/src/content/docs/reference/policies/BrowserDataBackup.mdx @@ -4,6 +4,8 @@ description: "Disable backup or restore of profile data." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable backup or restore of profile data. Backup and restore can be disabled individually. @@ -21,6 +23,10 @@ Software\Policies\Mozilla\Firefox\BrowserDataBackup\AllowBackup = 0x1 | 0x0 Software\Policies\Mozilla\Firefox\BrowserDataBackup\AllowRestore = 0x1 | 0x0 ``` +## Examples + + + ## Windows (Intune) OMA-URI: diff --git a/src/content/docs/reference/policies/CaptivePortal.mdx b/src/content/docs/reference/policies/CaptivePortal.mdx index 3331a26..19360c2 100644 --- a/src/content/docs/reference/policies/CaptivePortal.mdx +++ b/src/content/docs/reference/policies/CaptivePortal.mdx @@ -4,12 +4,18 @@ description: "Enable or disable the detection of captive portals." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable the detection of captive portals. **Compatibility:** Firefox 67, Firefox ESR 60.7\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.captive-portal-service.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Certificates.mdx b/src/content/docs/reference/policies/Certificates.mdx index ab16cc7..14899d6 100644 --- a/src/content/docs/reference/policies/Certificates.mdx +++ b/src/content/docs/reference/policies/Certificates.mdx @@ -4,12 +4,18 @@ description: "Add certificates or use built-in certificates." category: "Certificate management" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Install and manage certificates in Firefox. **Compatibility:** Firefox 60, Firefox ESR 60. `ImportEnterpriseRoots` macOS support added in Firefox 63/ESR 68, `Install` added in Firefox 64/ESR 64\ **CCK2 Equivalent:** `certs.ca` (Install)\ **Preferences Affected:** `security.enterprise_roots.enabled` +## Examples + + + ## Values `Certificates` accepts one or more of the following keys: diff --git a/src/content/docs/reference/policies/Containers.mdx b/src/content/docs/reference/policies/Containers.mdx index 8d892e5..adf9f04 100644 --- a/src/content/docs/reference/policies/Containers.mdx +++ b/src/content/docs/reference/policies/Containers.mdx @@ -4,12 +4,18 @@ description: "Set policies related to Multi-Account Containers." category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set policies related to [Multi-Account Containers](https://addons.mozilla.org/firefox/addon/multi-account-containers/). **Compatibility:** Firefox 113\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values Currently you can set the initial set of containers. diff --git a/src/content/docs/reference/policies/ContentAnalysis.mdx b/src/content/docs/reference/policies/ContentAnalysis.mdx index f021a27..afb4132 100644 --- a/src/content/docs/reference/policies/ContentAnalysis.mdx +++ b/src/content/docs/reference/policies/ContentAnalysis.mdx @@ -4,12 +4,18 @@ description: "Configure Firefox to use an agent for Data Loss Prevention (DLP) t category: "Cloud reporting" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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). **Compatibility:** Firefox 137\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.contentanalysis.agent_name`, `browser.contentanalysis.agent_timeout`, `browser.contentanalysis.allow_url_regex_list`, `browser.contentanalysis.bypass_for_same_tab_operations`, `browser.contentanalysis.client_signature`, `browser.contentanalysis.default_result`, `browser.contentanalysis.deny_url_regex_list`, `browser.contentanalysis.enabled`, `browser.contentanalysis.interception_point.clipboard.enabled`, `browser.contentanalysis.interception_point.clipboard.plain_text_only`, `browser.contentanalysis.interception_point.download.enabled`, `browser.contentanalysis.interception_point.drag_and_drop.enabled`, `browser.contentanalysis.interception_point.drag_and_drop.plain_text_only`, `browser.contentanalysis.interception_point.file_upload.enabled`, `browser.contentanalysis.interception_point.print.enabled`, `browser.contentanalysis.is_per_user`, `browser.contentanalysis.max_connections`, `browser.contentanalysis.pipe_path_name`, `browser.contentanalysis.show_blocked_result`, `browser.contentanalysis.timeout_result` +## Examples + + + ## Values - `AgentName` is the name of the DLP agent. This is used in dialogs and notifications about DLP operations. The default is "A DLP Agent". diff --git a/src/content/docs/reference/policies/Cookies.mdx b/src/content/docs/reference/policies/Cookies.mdx index 6e92af6..7c4ac9b 100644 --- a/src/content/docs/reference/policies/Cookies.mdx +++ b/src/content/docs/reference/policies/Cookies.mdx @@ -4,12 +4,18 @@ description: "Configure cookie preferences." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure cookie preferences. **Compatibility:** Firefox 60, Firefox ESR 60 (RejectTracker added in Firefox 63, AllowSession added in Firefox 79/78.1, Behavior added in Firefox 95/91.4)\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.cookie.cookieBehavior`, `network.cookie.cookieBehavior.pbmode`, `network.cookie.lifetimePolicy` +## Examples + + + ## Values - `Allow` is a list of origins (not domains) where cookies are always allowed. You must include `http` or `https`. diff --git a/src/content/docs/reference/policies/CrashReportsSubmit.mdx b/src/content/docs/reference/policies/CrashReportsSubmit.mdx index 298dba2..63b9a62 100644 --- a/src/content/docs/reference/policies/CrashReportsSubmit.mdx +++ b/src/content/docs/reference/policies/CrashReportsSubmit.mdx @@ -4,6 +4,8 @@ description: "Configure crash report submission settings." category: "Cloud reporting" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure crash report submission settings. **Compatibility:** Firefox Enterprise 150.0.0\ @@ -12,6 +14,10 @@ Configure crash report submission settings. > [!NOTE] > Currently, this is only implemented in Firefox Enterprise. +## Examples + + + ## Values - `ForceAutoSubmit` A Boolean. Controls whether crash reports are automatically submitted. diff --git a/src/content/docs/reference/policies/DNSOverHTTPS.mdx b/src/content/docs/reference/policies/DNSOverHTTPS.mdx index ffd3680..84ee34f 100644 --- a/src/content/docs/reference/policies/DNSOverHTTPS.mdx +++ b/src/content/docs/reference/policies/DNSOverHTTPS.mdx @@ -4,12 +4,18 @@ description: "Configure DNS over HTTPS (DoH)." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure DNS over HTTPS. **Compatibility:** Firefox 63, Firefox ESR 68 (ExcludedDomains added in 75/68.7) (Fallback added in 124)\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.trr.mode`, `network.trr.uri` +## Examples + + + ## Values - `Enabled` determines whether DNS over HTTPS is enabled diff --git a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx index b3b1ac1..b2f45f8 100644 --- a/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DefaultDownloadDirectory.mdx @@ -4,6 +4,8 @@ description: "Set the default download directory." category: "Downloads" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set the default download directory. You can use `${home}` for the native home directory. @@ -12,6 +14,10 @@ You can use `${home}` for the native home directory. **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.download.dir`, `browser.download.folderList` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx b/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx index a165ca4..1039abc 100644 --- a/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx +++ b/src/content/docs/reference/policies/DefaultSerialGuardSetting.mdx @@ -8,7 +8,7 @@ Control use of the [Web Serial API](https://developer.mozilla.org/en-US/docs/Web > [!NOTE] > If any policies are set, the WebSerial API will be blocked by default. To allow usage of the API, -set this policy to `3`. +> set this policy to `3`. **Compatibility:** Firefox 151\ **CCK2 Equivalent:** N/A\ diff --git a/src/content/docs/reference/policies/DisableAccounts.mdx b/src/content/docs/reference/policies/DisableAccounts.mdx index 465dcc3..e21b1aa 100644 --- a/src/content/docs/reference/policies/DisableAccounts.mdx +++ b/src/content/docs/reference/policies/DisableAccounts.mdx @@ -4,12 +4,18 @@ description: "Disable account-based services, including sync." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable account-based services, including sync. **Compatibility:** Firefox 119\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableAppUpdate.mdx b/src/content/docs/reference/policies/DisableAppUpdate.mdx index 8edee00..b33609c 100644 --- a/src/content/docs/reference/policies/DisableAppUpdate.mdx +++ b/src/content/docs/reference/policies/DisableAppUpdate.mdx @@ -4,12 +4,18 @@ description: "Turn off application updates within Firefox." category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Turn off application updates within Firefox. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableFirefoxUpdates`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx index 8057580..3827246 100644 --- a/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx +++ b/src/content/docs/reference/policies/DisableBuiltinPDFViewer.mdx @@ -4,6 +4,8 @@ description: "Disable the built in PDF viewer." category: "Printing" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable the built in PDF viewer. PDF files are downloaded and sent externally. > [!NOTE] As of Firefox 140, this policy no longer completely disables PDF.js; it changes the handler to send PDF files to the operating system. @@ -14,6 +16,10 @@ Disable the built in PDF viewer. PDF files are downloaded and sent externally. **CCK2 Equivalent:** `disablePDFjs`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx index 781029f..ca42e50 100644 --- a/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx +++ b/src/content/docs/reference/policies/DisableDefaultBrowserAgent.mdx @@ -4,6 +4,8 @@ description: "Prevent the default browser agent from taking any actions." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent the default browser agent from taking any actions. Only applicable to Windows; other platforms don't have the agent. @@ -14,6 +16,10 @@ More information is available in the [Default Browser Agent](https://firefox-sou **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableDeveloperTools.mdx b/src/content/docs/reference/policies/DisableDeveloperTools.mdx index 45b7fed..5fe376f 100644 --- a/src/content/docs/reference/policies/DisableDeveloperTools.mdx +++ b/src/content/docs/reference/policies/DisableDeveloperTools.mdx @@ -4,12 +4,18 @@ description: "Remove access to all developer tools." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove access to all developer tools. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `removeDeveloperTools`\ **Preferences Affected:** `devtools.policy.disabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx index 094baa1..339283e 100644 --- a/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx +++ b/src/content/docs/reference/policies/DisableEncryptedClientHello.mdx @@ -4,6 +4,8 @@ description: "Disable the TLS Feature for Encrypted Client Hello." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable the TLS Feature for 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. @@ -11,6 +13,10 @@ Note that TLS Client Hellos will still contain an ECH extension, but this extens **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.dns.echconfig.enabled`, `network.dns.http3_echconfig.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx index f4b4885..fabd12b 100644 --- a/src/content/docs/reference/policies/DisableFeedbackCommands.mdx +++ b/src/content/docs/reference/policies/DisableFeedbackCommands.mdx @@ -4,12 +4,18 @@ description: "Disable the menus for reporting sites (Submit Feedback, Report Dec category: "Browser UI" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable the menus for reporting sites (Submit Feedback, Report Deceptive Site). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx index 51383a2..7a8dcd6 100644 --- a/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxAccounts.mdx @@ -4,12 +4,18 @@ description: "Disable Firefox Accounts integration (Sync)." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable Firefox Accounts integration (Sync). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableSync`\ **Preferences Affected:** `identity.fxaccounts.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx index fc29961..9b085ca 100644 --- a/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxScreenshots.mdx @@ -4,12 +4,18 @@ description: "Remove access to Firefox Screenshots." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove access to Firefox Screenshots. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `extensions.screenshots.disabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx index cfdf3ec..81e7e63 100644 --- a/src/content/docs/reference/policies/DisableFirefoxStudies.mdx +++ b/src/content/docs/reference/policies/DisableFirefoxStudies.mdx @@ -4,12 +4,18 @@ description: "Disable Firefox studies (Shield)." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable Firefox studies (Shield). **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableForgetButton.mdx b/src/content/docs/reference/policies/DisableForgetButton.mdx index 005713c..299043d 100644 --- a/src/content/docs/reference/policies/DisableForgetButton.mdx +++ b/src/content/docs/reference/policies/DisableForgetButton.mdx @@ -4,12 +4,18 @@ description: 'Disable the "Forget" button.' category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable the "Forget" button. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableForget`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableFormHistory.mdx b/src/content/docs/reference/policies/DisableFormHistory.mdx index 0251ad2..8226581 100644 --- a/src/content/docs/reference/policies/DisableFormHistory.mdx +++ b/src/content/docs/reference/policies/DisableFormHistory.mdx @@ -4,12 +4,18 @@ description: "Turn off saving information on web forms and the search bar." category: "Local data storage" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Turn off saving information on web forms and the search bar. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableFormFill`\ **Preferences Affected:** `browser.formfill.enable` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx index be75b28..a90c5cf 100644 --- a/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx +++ b/src/content/docs/reference/policies/DisableMasterPasswordCreation.mdx @@ -4,6 +4,8 @@ description: "Remove the master password functionality." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove the master password functionality. If this value is `true`, it works the same as setting [`PrimaryPassword`](/reference/policies/primarypassword/) to `false` and removes the primary password functionality. @@ -14,6 +16,10 @@ If both `DisableMasterPasswordCreation` and [`PrimaryPassword`](/reference/polic **CCK2 Equivalent:** `noMasterPassword`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePasswordReveal.mdx b/src/content/docs/reference/policies/DisablePasswordReveal.mdx index 6433d95..c83086a 100644 --- a/src/content/docs/reference/policies/DisablePasswordReveal.mdx +++ b/src/content/docs/reference/policies/DisablePasswordReveal.mdx @@ -4,12 +4,18 @@ description: "Do not allow passwords to be shown in saved logins" category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Do not allow passwords to be shown in saved logins. **Compatibility:** Firefox 71, Firefox ESR 68.3\ **CCK2 Equivalent:** N/A **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePocket.mdx b/src/content/docs/reference/policies/DisablePocket.mdx index d087b5d..559a005 100644 --- a/src/content/docs/reference/policies/DisablePocket.mdx +++ b/src/content/docs/reference/policies/DisablePocket.mdx @@ -4,12 +4,18 @@ description: "Remove Pocket in the Firefox UI." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove Pocket in the Firefox UI. It does not remove it from the new tab page. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disablePocket`\ **Preferences Affected:** `extensions.pocket.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx index 9db1e10..1482b63 100644 --- a/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx +++ b/src/content/docs/reference/policies/DisablePrivateBrowsing.mdx @@ -4,6 +4,8 @@ description: "Remove access to private browsing." category: "Browsing restrictions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove access to private browsing. This policy is superseded by the [`PrivateBrowsingModeAvailability`](/reference/policies/privatebrowsingmodeavailability/) policy. @@ -12,6 +14,10 @@ This policy is superseded by the [`PrivateBrowsingModeAvailability`](/reference/ **CCK2 Equivalent:** `disablePrivateBrowsing`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileImport.mdx b/src/content/docs/reference/policies/DisableProfileImport.mdx index a80202a..e374bef 100644 --- a/src/content/docs/reference/policies/DisableProfileImport.mdx +++ b/src/content/docs/reference/policies/DisableProfileImport.mdx @@ -4,12 +4,18 @@ description: "Remove the ability to import data from other browsers." category: "Bookmarks" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove the ability to import data from other browsers. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableProfileRefresh.mdx b/src/content/docs/reference/policies/DisableProfileRefresh.mdx index 8d44584..562454c 100644 --- a/src/content/docs/reference/policies/DisableProfileRefresh.mdx +++ b/src/content/docs/reference/policies/DisableProfileRefresh.mdx @@ -4,12 +4,18 @@ description: "Disable the Refresh Firefox button on 'about:support' and 'support category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `disableResetFirefox`\ **Preferences Affected:** `browser.disableResetPrompt` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx index cd66f3c..383d1d4 100644 --- a/src/content/docs/reference/policies/DisableRemoteImprovements.mdx +++ b/src/content/docs/reference/policies/DisableRemoteImprovements.mdx @@ -4,12 +4,18 @@ description: "Prevent Firefox from applying performance, stability, and feature category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent Firefox from applying performance, stability, and feature changes between updates. **Compatibility:** Firefox 148\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSafeMode.mdx b/src/content/docs/reference/policies/DisableSafeMode.mdx index 60efe40..11917bf 100644 --- a/src/content/docs/reference/policies/DisableSafeMode.mdx +++ b/src/content/docs/reference/policies/DisableSafeMode.mdx @@ -4,6 +4,8 @@ description: "Disable safe mode (Troubleshoot Mode) within the browser." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable safe mode ([Troubleshoot Mode](https://support.mozilla.org/en-US/kb/diagnose-firefox-issues-using-troubleshoot-mode)) within the browser. On Windows, this disables safe mode via the command line as well. @@ -12,6 +14,10 @@ On Windows, this disables safe mode via the command line as well. **CCK2 Equivalent:** `disableSafeMode`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSecurityBypass.mdx b/src/content/docs/reference/policies/DisableSecurityBypass.mdx index 6891364..48513b1 100644 --- a/src/content/docs/reference/policies/DisableSecurityBypass.mdx +++ b/src/content/docs/reference/policies/DisableSecurityBypass.mdx @@ -4,6 +4,8 @@ description: "Prevent the user from bypassing security in certain cases." category: "Certificate management" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent the user from bypassing security in certain cases. These policies only affect what happens when an error is shown, they do not affect any settings in preferences. @@ -12,6 +14,10 @@ These policies only affect what happens when an error is shown, they do not affe **CCK2 Equivalent:** N/A\ **Preferences Affected:** `security.certerror.hideAddException`, `browser.safebrowsing.allowOverride` +## Examples + + + ## Values - `InvalidCertificate`: Prevents adding an exception when an invalid certificate is shown. diff --git a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx index 0403cce..7aa47a1 100644 --- a/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx +++ b/src/content/docs/reference/policies/DisableSetDesktopBackground.mdx @@ -4,12 +4,18 @@ description: 'Remove the "Set As Desktop Background..." menuitem when right clic category: "Browser UI" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove the "Set As Desktop Background..." menuitem when right clicking on an image. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `removeSetDesktopBackground`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx index ee706b5..d3b20eb 100644 --- a/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx +++ b/src/content/docs/reference/policies/DisableSystemAddonUpdate.mdx @@ -4,12 +4,18 @@ description: "Prevent system add-ons from being installed or updated." category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent system add-ons from being installed or updated. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisableTelemetry.mdx b/src/content/docs/reference/policies/DisableTelemetry.mdx index c92f1ea..ca8a87c 100644 --- a/src/content/docs/reference/policies/DisableTelemetry.mdx +++ b/src/content/docs/reference/policies/DisableTelemetry.mdx @@ -4,6 +4,8 @@ description: "Prevent the upload of telemetry data." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent the upload of telemetry data. As of Firefox 83 and Firefox ESR 78.5, local storage of telemetry data is disabled as well. @@ -15,6 +17,10 @@ Information collected through telemetry helps us build a better product for busi **CCK2 Equivalent:** `disableTelemetry`\ **Preferences Affected:** `datareporting.healthreport.uploadEnabled`, `datareporting.policy.dataSubmissionEnabled`, `toolkit.telemetry.archive.enabled`, `datareporting.usage.uploadEnabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/DisabledCiphers.mdx b/src/content/docs/reference/policies/DisabledCiphers.mdx index 0268f5c..3aba278 100644 --- a/src/content/docs/reference/policies/DisabledCiphers.mdx +++ b/src/content/docs/reference/policies/DisabledCiphers.mdx @@ -4,6 +4,8 @@ description: "Disable specific cryptographic ciphers, listed below." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable specific cryptographic ciphers. > [!NOTE] @@ -15,6 +17,10 @@ Disable specific cryptographic ciphers. **CCK2 Equivalent:** N/A\ **Preferences Affected:** `security.ssl3.ecdhe_rsa_aes_128_gcm_sha256`, `security.ssl3.ecdhe_ecdsa_aes_128_gcm_sha256`, `security.ssl3.ecdhe_ecdsa_chacha20_poly1305_sha256`, `security.ssl3.ecdhe_rsa_chacha20_poly1305_sha256`, `security.ssl3.ecdhe_ecdsa_aes_256_gcm_sha384`, `security.ssl3.ecdhe_rsa_aes_256_gcm_sha384`, `security.ssl3.ecdhe_rsa_aes_128_sha`, `security.ssl3.ecdhe_ecdsa_aes_128_sha`, `security.ssl3.ecdhe_rsa_aes_256_sha`, `security.ssl3.ecdhe_ecdsa_aes_256_sha`, `security.ssl3.dhe_rsa_aes_128_sha`, `security.ssl3.dhe_rsa_aes_256_sha`, `security.ssl3.rsa_aes_128_gcm_sha256`, `security.ssl3.rsa_aes_256_gcm_sha384`, `security.ssl3.rsa_aes_128_sha`, `security.ssl3.rsa_aes_256_sha`, `security.ssl3.deprecated.rsa_des_ede3_sha`, `security.tls13.chacha20_poly1305_sha256`, `security.tls13.aes_128_gcm_sha256`, `security.tls13.aes_256_gcm_sha384` +## Examples + + + ## Values The following cryptographic cyphers are configurable as `CIPHER_NAME`: diff --git a/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx b/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx index d01c97c..54ce6a4 100644 --- a/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx +++ b/src/content/docs/reference/policies/DisplayBookmarksToolbar.mdx @@ -4,12 +4,18 @@ description: "Set the initial state of the bookmarks toolbar." category: "Bookmarks" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set the initial state of the bookmarks toolbar. A user can still change how it is displayed. **Compatibility:** Firefox 109, Firefox ESR 102.7\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values - `always` means the bookmarks toolbar is always shown. diff --git a/src/content/docs/reference/policies/DisplayMenuBar.mdx b/src/content/docs/reference/policies/DisplayMenuBar.mdx index d0cfd41..4b64c0c 100644 --- a/src/content/docs/reference/policies/DisplayMenuBar.mdx +++ b/src/content/docs/reference/policies/DisplayMenuBar.mdx @@ -4,12 +4,18 @@ description: "Set the state of the menubar." category: "Browser UI" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set the state of the menubar. **Compatibility:** Firefox 73, Firefox ESR 68.5 (Windows, some Linux)\ **CCK2 Equivalent:** `displayMenuBar`\ **Preferences Affected:** N/A +## Examples + + + ## Values - `always` means the menubar is shown and cannot be hidden. diff --git a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx index 6b0c2ac..7033b4d 100644 --- a/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx +++ b/src/content/docs/reference/policies/DontCheckDefaultBrowser.mdx @@ -4,12 +4,18 @@ description: "Don't check if Firefox is the default browser at startup." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Don't check if Firefox is the default browser at startup. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `dontCheckDefaultBrowser`\ **Preferences Affected:** `browser.shell.checkDefaultBrowser` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/EnableTrackingProtection.mdx b/src/content/docs/reference/policies/EnableTrackingProtection.mdx index d9b201e..24604b2 100644 --- a/src/content/docs/reference/policies/EnableTrackingProtection.mdx +++ b/src/content/docs/reference/policies/EnableTrackingProtection.mdx @@ -4,6 +4,8 @@ description: "Configure tracking protection." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure tracking protection. 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. @@ -12,6 +14,10 @@ If this policy is not configured, tracking protection is not enabled by default **CCK2 Equivalent:** N/A\ **Preferences Affected:** `privacy.trackingprotection.enabled`, `privacy.trackingprotection.pbmode.enabled`, `privacy.trackingprotection.cryptomining.enabled`, `privacy.trackingprotection.fingerprinting.enabled`, `privacy.fingerprintingProtection`, `privacy.trackingprotection.emailtracking.enabled`, `privacy.trackingprotection.emailtracking.pbmode.enabled`, `privacy.trackingprotection.allow_list.baseline.enabled`, `privacy.trackingprotection.allow_list.convenience.enabled` +## Examples + + + ## Values - If `Value` is set to false, tracking protection is disabled and locked in both the regular browser and private browsing. diff --git a/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx b/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx index 15b267d..c6bacd2 100644 --- a/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx +++ b/src/content/docs/reference/policies/EncryptedMediaExtensions.mdx @@ -4,12 +4,18 @@ description: "Enable or disable Encrypted Media Extensions and optionally lock i category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable Encrypted Media Extensions and optionally lock it. **Compatibility:** Firefox 77, Firefox ESR 68.9\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `media.eme.enabled` +## 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. diff --git a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx index 5f66dfa..c8b7448 100644 --- a/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx +++ b/src/content/docs/reference/policies/ExemptDomainFileTypePairsFromFileTypeDownloadWarnings.mdx @@ -4,6 +4,8 @@ description: "Disable warnings based on file extension for specific file types o category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable warnings based on file extension for specific file types on domains. This policy is based on the [Chrome policy](https://chromeenterprise.google/policies/#ExemptDomainFileTypePairsFromFileTypeDownloadWarnings) of the same name. @@ -16,6 +18,10 @@ This policy is based on the [Chrome policy](https://chromeenterprise.google/poli **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ExtensionSettings.mdx b/src/content/docs/reference/policies/ExtensionSettings.mdx index 2c23a2c..dfc6014 100644 --- a/src/content/docs/reference/policies/ExtensionSettings.mdx +++ b/src/content/docs/reference/policies/ExtensionSettings.mdx @@ -4,6 +4,8 @@ description: "Manage all aspects of extensions." category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Manage all aspects of extensions. This policy is based heavily on the [Chrome policy](https://dev.chromium.org/administrators/policy-list-3/extension-settings-full) of the same name. @@ -21,6 +23,10 @@ You can [download an extension on AMO](https://github.com/mkaply/queryamoid/rele **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values The configuration for each extension is a dictionary that can contain the fields documented below. diff --git a/src/content/docs/reference/policies/ExtensionUpdate.mdx b/src/content/docs/reference/policies/ExtensionUpdate.mdx index 9169ada..2f6f8f6 100644 --- a/src/content/docs/reference/policies/ExtensionUpdate.mdx +++ b/src/content/docs/reference/policies/ExtensionUpdate.mdx @@ -4,12 +4,18 @@ description: "Control extension updates." category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Control extension updates. **Compatibility:** Firefox 67, Firefox ESR 60.7\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `extensions.update.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Extensions.mdx b/src/content/docs/reference/policies/Extensions.mdx index a7584a8..35732c9 100644 --- a/src/content/docs/reference/policies/Extensions.mdx +++ b/src/content/docs/reference/policies/Extensions.mdx @@ -4,6 +4,8 @@ description: "Control the installation, uninstallation and locking of extensions category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Control the installation, uninstallation and locking of extensions. > [!WARNING] @@ -16,6 +18,10 @@ Control the installation, uninstallation and locking of extensions. **CCK2 Equivalent:** `addons`\ **Preferences Affected:** N/A +## Examples + + + ## Values - `Install` is a list of URLs or native paths for extensions to be installed. diff --git a/src/content/docs/reference/policies/FirefoxHome.mdx b/src/content/docs/reference/policies/FirefoxHome.mdx index 669819c..885e97e 100644 --- a/src/content/docs/reference/policies/FirefoxHome.mdx +++ b/src/content/docs/reference/policies/FirefoxHome.mdx @@ -4,12 +4,18 @@ description: "Customize the Firefox Home page." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Customize the Firefox Home page. **Compatibility:** Firefox 68, Firefox ESR 68 (`SponsoredTopSites` and `SponsoredPocket` were added in Firefox 95, Firefox ESR 91.4, Snippets was deprecated in Firefox 122, Stories and SponsoredStories were added in Firefox 141 to replace Pocket and SponsoredPocket.)\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.newtabpage.activity-stream.showSearch`, `browser.newtabpage.activity-stream.feeds.topsites`, `browser.newtabpage.activity-stream.feeds.section.highlights`, `browser.newtabpage.activity-stream.feeds.section.topstories`, `browser.newtabpage.activity-stream.feeds.snippets`, `browser.newtabpage.activity-stream.showSponsoredTopSites`, `browser.newtabpage.activity-stream.showSponsored` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/FirefoxSuggest.mdx b/src/content/docs/reference/policies/FirefoxSuggest.mdx index ebb4a74..6e4c615 100644 --- a/src/content/docs/reference/policies/FirefoxSuggest.mdx +++ b/src/content/docs/reference/policies/FirefoxSuggest.mdx @@ -4,6 +4,8 @@ description: "Customize Firefox Suggest (US only)." category: "Search" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Customize Firefox Suggest (US only). As of Firefox 146, `WebSuggestions` turns off Suggest completely. @@ -11,6 +13,10 @@ As of Firefox 146, `WebSuggestions` turns off Suggest completely. **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.urlbar.suggest.quicksuggest.all`, `browser.urlbar.suggest.quicksuggest.sponsored`, `browser.urlbar.quicksuggest.dataCollection.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/GenerativeAI.mdx b/src/content/docs/reference/policies/GenerativeAI.mdx index a96877c..7f06e27 100644 --- a/src/content/docs/reference/policies/GenerativeAI.mdx +++ b/src/content/docs/reference/policies/GenerativeAI.mdx @@ -4,12 +4,18 @@ description: "Configure generative AI features." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure generative AI features. **Compatibility:** Firefox 144, Firefox ESR 140.4\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.chat.page`, `browser.ml.linkPreview.optin`, `browser.tabs.groups.smart.userEnabled` +## Examples + + + ## Values - `Enabled` Controls whether generative AI features are enabled by default. diff --git a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx index 9128db4..f16b4c5 100644 --- a/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx +++ b/src/content/docs/reference/policies/GoToIntranetSiteForSingleWordEntryInAddressBar.mdx @@ -4,12 +4,18 @@ description: "Whether to always go through the DNS server before sending a singl category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Whether to always go through the DNS server before sending a single word search string to a search engine. **Compatibility:** Firefox 104, Firefox ESR 102.2\ **CCK2 Equivalent:** `N/A`\ **Preferences Affected:** `browser.fixup.dns_first_for_single_words` +## 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 40e5b58..79fbb98 100644 --- a/src/content/docs/reference/policies/Handlers.mdx +++ b/src/content/docs/reference/policies/Handlers.mdx @@ -3,6 +3,8 @@ title: "Handlers" description: "Configure default application handlers." --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure default application handlers. This policy is based on the internal format of `handlers.json`. @@ -12,6 +14,10 @@ You can configure handlers based on a [mime type](https://developer.mozilla.org/ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## 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. diff --git a/src/content/docs/reference/policies/HardwareAcceleration.mdx b/src/content/docs/reference/policies/HardwareAcceleration.mdx index f277e86..ca7e1af 100644 --- a/src/content/docs/reference/policies/HardwareAcceleration.mdx +++ b/src/content/docs/reference/policies/HardwareAcceleration.mdx @@ -4,12 +4,18 @@ description: "Control hardware acceleration." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Control hardware acceleration. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `layers.acceleration.disabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Homepage.mdx b/src/content/docs/reference/policies/Homepage.mdx index 455b8b6..85cb7da 100644 --- a/src/content/docs/reference/policies/Homepage.mdx +++ b/src/content/docs/reference/policies/Homepage.mdx @@ -4,12 +4,18 @@ description: "Configure the default homepage and how Firefox starts." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure the default homepage and how Firefox starts. **Compatibility:** Firefox 60, Firefox ESR 60 (StartPage was added in Firefox 60, Firefox ESR 60.4, homepage-locked added in Firefox 78)\ **CCK2 Equivalent:** `homePage`,`lockHomePage`\ **Preferences Affected:** `browser.startup.homepage`, `browser.startup.page` +## Examples + + + ## Values The following members are configurable: diff --git a/src/content/docs/reference/policies/HttpAllowlist.mdx b/src/content/docs/reference/policies/HttpAllowlist.mdx index 8f86d6e..7b0e6da 100644 --- a/src/content/docs/reference/policies/HttpAllowlist.mdx +++ b/src/content/docs/reference/policies/HttpAllowlist.mdx @@ -4,6 +4,8 @@ description: "Configure sites that will not be upgraded to HTTPS." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure sites that will not be upgraded to HTTPS. The sites are specified as a list of origins. @@ -11,6 +13,10 @@ The sites are specified as a list of origins. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/HttpsOnlyMode.mdx b/src/content/docs/reference/policies/HttpsOnlyMode.mdx index 540f976..4fbf808 100644 --- a/src/content/docs/reference/policies/HttpsOnlyMode.mdx +++ b/src/content/docs/reference/policies/HttpsOnlyMode.mdx @@ -4,12 +4,18 @@ description: "Configure HTTPS-Only Mode." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure HTTPS-Only Mode. **Compatibility:** Firefox 127\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `dom.security.https_only_mode` +## Examples + + + ## Values | Value | Description | diff --git a/src/content/docs/reference/policies/IPProtectionAvailable.mdx b/src/content/docs/reference/policies/IPProtectionAvailable.mdx index b715df3..14b74e3 100644 --- a/src/content/docs/reference/policies/IPProtectionAvailable.mdx +++ b/src/content/docs/reference/policies/IPProtectionAvailable.mdx @@ -4,12 +4,18 @@ description: "Prevent the built-in VPN from being available to users." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent the built-in VPN from being available to users. **Compatibility:** Firefox 149\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.ipProtection.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/InstallAddonsPermission.mdx b/src/content/docs/reference/policies/InstallAddonsPermission.mdx index d7bc663..2d53a87 100644 --- a/src/content/docs/reference/policies/InstallAddonsPermission.mdx +++ b/src/content/docs/reference/policies/InstallAddonsPermission.mdx @@ -4,12 +4,18 @@ description: "Configure the default extension install policy as well as origins category: "Extensions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `permissions.install`\ **Preferences Affected:** `xpinstall.enabled`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features` +## Examples + + + ## Values - `Allow` is a list of origins where extension installs are allowed. diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx index 632ef66..a8bdba5 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabled.mdx @@ -4,6 +4,8 @@ description: "Enable default legacy SameSite cookie behavior setting." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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`. @@ -12,6 +14,10 @@ If this policy is set to true, it reverts all cookies to legacy SameSite behavio **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.cookie.sameSite.laxByDefault` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx index 4549540..ef380a1 100644 --- a/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx +++ b/src/content/docs/reference/policies/LegacySameSiteCookieBehaviorEnabledForDomainList.mdx @@ -4,6 +4,8 @@ description: "Revert to legacy SameSite behavior for cookies on specified sites. category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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`. @@ -12,6 +14,10 @@ If this policy is set to true, cookies set for domains in this list will revert **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.cookie.sameSite.laxByDefault.disabledHosts` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LocalFileLinks.mdx b/src/content/docs/reference/policies/LocalFileLinks.mdx index 007dc04..8c9512d 100644 --- a/src/content/docs/reference/policies/LocalFileLinks.mdx +++ b/src/content/docs/reference/policies/LocalFileLinks.mdx @@ -4,12 +4,18 @@ description: "Enable linking to local files by origin." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable linking to local files by origin. **Compatibility:** Firefox 68, Firefox ESR 68\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `capability.policy.localfilelinks.*` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/LocalNetworkAccess.mdx b/src/content/docs/reference/policies/LocalNetworkAccess.mdx index f58da67..4912b21 100644 --- a/src/content/docs/reference/policies/LocalNetworkAccess.mdx +++ b/src/content/docs/reference/policies/LocalNetworkAccess.mdx @@ -4,6 +4,8 @@ description: "Configure local network access security features." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure local network access security features. The `LocalNetworkAccess` policy controls Firefox's behavior when websites attempt to access local network resources (localhost and local network addresses). @@ -11,6 +13,10 @@ The `LocalNetworkAccess` policy controls Firefox's behavior when websites attemp **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.lna.enabled`, `network.lna.block_trackers`, `network.lna.blocking`, `network.lna.skip-domains` +## Examples + + + ## Values - `Enabled`: a Boolean that enables or disables the policy. diff --git a/src/content/docs/reference/policies/ManagedBookmarks.mdx b/src/content/docs/reference/policies/ManagedBookmarks.mdx index d19f3f7..a2b846e 100644 --- a/src/content/docs/reference/policies/ManagedBookmarks.mdx +++ b/src/content/docs/reference/policies/ManagedBookmarks.mdx @@ -4,6 +4,8 @@ description: "Configures a list of bookmarks managed by an administrator that ca category: "Bookmarks" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configures a list of bookmarks managed by an administrator that cannot be changed by the user. The bookmarks are only added as a button on the personal toolbar. They are not in the bookmarks folder. @@ -42,6 +44,10 @@ The schema is: **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## 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 e84cb05..ebf42b7 100644 --- a/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx +++ b/src/content/docs/reference/policies/ManualAppUpdateOnly.mdx @@ -4,6 +4,8 @@ description: "Switch to manual updates only." category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Switch to manual updates only. If this policy is enabled: @@ -18,6 +20,10 @@ This policy is primarily intended for advanced end users, not for enterprises, b **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx index 6c239e8..9efd2e9 100644 --- a/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx +++ b/src/content/docs/reference/policies/MicrosoftEntraSSO.mdx @@ -4,6 +4,8 @@ description: "Allow single sign-on for Microsoft Entra accounts on macOS." category: "Authentication" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Allow single sign-on for Microsoft Entra accounts on macOS. If this policy is set to `true`, Firefox will use credentials stored in the Company Portal to sign in to Microsoft Entra accounts. @@ -12,6 +14,10 @@ If this policy is set to `true`, Firefox will use credentials stored in the Comp **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.http.microsoft-entra-sso.enabled` +## Examples + + + ## macOS ```xml diff --git a/src/content/docs/reference/policies/NetworkPrediction.mdx b/src/content/docs/reference/policies/NetworkPrediction.mdx index 6395eab..784d838 100644 --- a/src/content/docs/reference/policies/NetworkPrediction.mdx +++ b/src/content/docs/reference/policies/NetworkPrediction.mdx @@ -4,12 +4,18 @@ description: "Enable or disable network prediction (DNS prefetching)." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable network prediction ([DNS prefetching](https://developer.mozilla.org/en-US/docs/Glossary/Prefetch#dns_prefetching)). **Compatibility:** Firefox 67, Firefox ESR 60.7\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.dns.disablePrefetch`, `network.dns.disablePrefetchFromHTTPS` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NewTabPage.mdx b/src/content/docs/reference/policies/NewTabPage.mdx index 99b7232..7a083a2 100644 --- a/src/content/docs/reference/policies/NewTabPage.mdx +++ b/src/content/docs/reference/policies/NewTabPage.mdx @@ -4,12 +4,18 @@ description: "Enable or disable the New Tab page." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable the New Tab page. **Compatibility:** Firefox 68, Firefox ESR 68\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.newtabpage.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx index 7aee42e..a81e342 100644 --- a/src/content/docs/reference/policies/NoDefaultBookmarks.mdx +++ b/src/content/docs/reference/policies/NoDefaultBookmarks.mdx @@ -4,6 +4,8 @@ description: "Disable the creation of default bookmarks." category: "Bookmarks" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable the creation of default bookmarks. This policy is only effective if the user profile has not been created yet. @@ -12,6 +14,10 @@ This policy is only effective if the user profile has not been created yet. **CCK2 Equivalent:** `removeDefaultBookmarks`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLogins.mdx b/src/content/docs/reference/policies/OfferToSaveLogins.mdx index ba8837f..9d5917f 100644 --- a/src/content/docs/reference/policies/OfferToSaveLogins.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLogins.mdx @@ -4,12 +4,18 @@ description: "Control whether or not Firefox offers to save passwords." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Control whether or not Firefox offers to save passwords. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `dontRememberPasswords`\ **Preferences Affected:** `signon.rememberSignons` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx index 8b821b8..9e436ae 100644 --- a/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx +++ b/src/content/docs/reference/policies/OfferToSaveLoginsDefault.mdx @@ -4,12 +4,18 @@ description: "Sets the default value of 'signon.rememberSignons' without locking category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Sets the default value of `signon.rememberSignons` without locking it. **Compatibility:** Firefox 70, Firefox ESR 60.2\ **CCK2 Equivalent:** `dontRememberPasswords`\ **Preferences Affected:** `signon.rememberSignons` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx index e2265f4..c714b90 100644 --- a/src/content/docs/reference/policies/OverrideFirstRunPage.mdx +++ b/src/content/docs/reference/policies/OverrideFirstRunPage.mdx @@ -4,6 +4,8 @@ description: "Override the first run page." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Override the first run page. If the value is an empty string (`""`), the first run page is not displayed. Starting with Firefox 83, Firefox ESR 78.5, you can also specify multiple URLs separated by a vertical bar (`|`). @@ -12,6 +14,10 @@ Starting with Firefox 83, Firefox ESR 78.5, you can also specify multiple URLs s **CCK2 Equivalent:** `welcomePage`,`noWelcomePage`\ **Preferences Affected:** `startup.homepage_welcome_url` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx index c729df2..8c052e6 100644 --- a/src/content/docs/reference/policies/OverridePostUpdatePage.mdx +++ b/src/content/docs/reference/policies/OverridePostUpdatePage.mdx @@ -4,12 +4,18 @@ description: "Override the upgrade page." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Override the upgrade page. If the value is an empty string (`""`), no extra pages are displayed when Firefox is upgraded. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `upgradePage`,`noUpgradePage`\ **Preferences Affected:** `startup.homepage_override_url` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PDFjs.mdx b/src/content/docs/reference/policies/PDFjs.mdx index 3e4e4c8..9ab6d6c 100644 --- a/src/content/docs/reference/policies/PDFjs.mdx +++ b/src/content/docs/reference/policies/PDFjs.mdx @@ -4,6 +4,8 @@ description: "Disable or configure PDF.js, the built-in PDF viewer." category: "Printing" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Disable or configure PDF.js, the built-in PDF viewer. > [!NOTE] @@ -14,6 +16,10 @@ Disable or configure PDF.js, the built-in PDF viewer. **CCK2 Equivalent:** N/A\ **Preferences Affected:** `pdfjs.disabled`, `pdfjs.enablePermissions` +## Examples + + + ## Values - If `Enabled` is set to `false`, the built-in PDF viewer is disabled. diff --git a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx index 5db33ca..abab78d 100644 --- a/src/content/docs/reference/policies/PasswordManagerEnabled.mdx +++ b/src/content/docs/reference/policies/PasswordManagerEnabled.mdx @@ -4,12 +4,18 @@ description: "Remove access to the password manager via preferences and blocks a category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Remove access to the password manager via preferences and blocks about:logins on Firefox 70. **Compatibility:** Firefox 70, Firefox ESR 60.2\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `pref.privacy.disable_button.view_passwords`, `signon.rememberSignons` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx index e2aa104..0679de5 100644 --- a/src/content/docs/reference/policies/PasswordManagerExceptions.mdx +++ b/src/content/docs/reference/policies/PasswordManagerExceptions.mdx @@ -4,6 +4,8 @@ description: "Prevent Firefox from saving passwords for specific sites." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent Firefox from saving passwords for specific sites. The sites are specified as a list of origins. @@ -12,6 +14,10 @@ The sites are specified as a list of origins. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Permissions.mdx b/src/content/docs/reference/policies/Permissions.mdx index 6329344..f288da5 100644 --- a/src/content/docs/reference/policies/Permissions.mdx +++ b/src/content/docs/reference/policies/Permissions.mdx @@ -4,6 +4,8 @@ description: "Set permissions associated with camera, microphone, location, noti category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set permissions associated with camera, microphone, location, notifications, autoplay, and virtual reality. Because these are origins, not domains, entries with unique ports must be specified separately. This explicitly means that it is not possible to add wildcards. See examples below. @@ -12,6 +14,10 @@ This explicitly means that it is not possible to add wildcards. See examples bel **CCK2 Equivalent:** N/A\ **Preferences Affected:** `permissions.default.camera`, `permissions.default.microphone`, `permissions.default.geo`, `permissions.default.desktop-notification`, `media.autoplay.default`, `permissions.default.xr`, `permissions.default.screen` +## Examples + + + ## Values - `Allow` is a list of origins where the feature is allowed. diff --git a/src/content/docs/reference/policies/PictureInPicture.mdx b/src/content/docs/reference/policies/PictureInPicture.mdx index 6a5496c..419a9e8 100644 --- a/src/content/docs/reference/policies/PictureInPicture.mdx +++ b/src/content/docs/reference/policies/PictureInPicture.mdx @@ -4,12 +4,18 @@ description: "Enable or disable Picture-in-Picture as well as prevent the user f category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable Picture-in-Picture as well as prevent the user from enabling or disabling it (Locked). **Compatibility:** Firefox 78, Firefox ESR 78\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `media.videocontrols.picture-in-picture.video-toggle.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PopupBlocking.mdx b/src/content/docs/reference/policies/PopupBlocking.mdx index c53df16..a849b55 100644 --- a/src/content/docs/reference/policies/PopupBlocking.mdx +++ b/src/content/docs/reference/policies/PopupBlocking.mdx @@ -4,12 +4,18 @@ description: "Allow certain websites to display popups and be redirected by thir category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Allow certain websites to display popups and be redirected by third-party frames. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `permissions.popup`\ **Preferences Affected:** `dom.disable_open_during_load` +## Examples + + + ## Values - `Allow` is a list of origins where popup-windows and third-party redirects are allowed. diff --git a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx index c1f23ca..3d299d5 100644 --- a/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx +++ b/src/content/docs/reference/policies/PostQuantumKeyAgreementEnabled.mdx @@ -4,12 +4,18 @@ description: "Enable post-quantum key agreement for TLS." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable post-quantum key agreement for TLS. **Compatibility:** Firefox 127\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `security.tls.enable_kyber`, `network.http.http3.enable_kyber` (Firefox 128) +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Preferences.mdx b/src/content/docs/reference/policies/Preferences.mdx index 43c1e06..a9bde0d 100644 --- a/src/content/docs/reference/policies/Preferences.mdx +++ b/src/content/docs/reference/policies/Preferences.mdx @@ -4,6 +4,8 @@ description: "Set and lock preferences." category: "Security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set and lock preferences. Previously you could only set and lock a subset of preferences. @@ -21,6 +23,10 @@ You can also set default preferences, user preferences and you can clear prefere **CCK2 Equivalent:** `preferences`\ **Preferences Affected:** Many +## Examples + + + ## Values Preferences that start with the following prefixes are supported: diff --git a/src/content/docs/reference/policies/PrimaryPassword.mdx b/src/content/docs/reference/policies/PrimaryPassword.mdx index 7848fbe..5c0b21e 100644 --- a/src/content/docs/reference/policies/PrimaryPassword.mdx +++ b/src/content/docs/reference/policies/PrimaryPassword.mdx @@ -4,6 +4,8 @@ description: "Require or prevent using a primary (formerly master) password." category: "Password manager" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Require or prevent using a primary (formerly master) password. If this value is true, a primary password is required. @@ -15,6 +17,10 @@ If both `DisableMasterPasswordCreation` and `PrimaryPassword` are used, `Disable **CCK2 Equivalent:** `noMasterPassword`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrintingEnabled.mdx b/src/content/docs/reference/policies/PrintingEnabled.mdx index 18ae9bb..a5a6e1f 100644 --- a/src/content/docs/reference/policies/PrintingEnabled.mdx +++ b/src/content/docs/reference/policies/PrintingEnabled.mdx @@ -4,12 +4,18 @@ description: "Enable or disable printing." category: "Printing" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable printing. **Compatibility:** Firefox 120, Firefox ESR 115.5\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `print.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx index e8f3d62..2e1e1df 100644 --- a/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx +++ b/src/content/docs/reference/policies/PrivateBrowsingModeAvailability.mdx @@ -4,6 +4,8 @@ description: "Set availability of private browsing mode." category: "Browsing restrictions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set availability of private browsing mode. This policy supersedes [`DisablePrivateBrowsing`](/reference/policies/disableprivatebrowsing/) @@ -14,6 +16,10 @@ This policy supersedes [`DisablePrivateBrowsing`](/reference/policies/disablepri **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values `PrivateBrowsingModeAvailability` expects one of the following number values: diff --git a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx index 1af70c2..8ccac6c 100644 --- a/src/content/docs/reference/policies/PromptForDownloadLocation.mdx +++ b/src/content/docs/reference/policies/PromptForDownloadLocation.mdx @@ -4,12 +4,18 @@ description: "Ask where to save each file before downloading." category: "Downloads" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Ask where to save each file before downloading. **Compatibility:** Firefox 68, Firefox ESR 68\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.download.useDownloadDir` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Proxy.mdx b/src/content/docs/reference/policies/Proxy.mdx index 02b7a7d..c218f35 100644 --- a/src/content/docs/reference/policies/Proxy.mdx +++ b/src/content/docs/reference/policies/Proxy.mdx @@ -4,6 +4,8 @@ description: "Configure proxy settings." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure proxy settings. These settings correspond to the connection settings in Firefox preferences. To specify ports, append them to the hostnames with a colon (:). @@ -13,6 +15,10 @@ Unless you lock this policy, changes the user already has in place will take eff **CCK2 Equivalent:** `networkProxy*`\ **Preferences Affected:** `network.proxy.type`, `network.proxy.autoconfig_url`, `network.proxy.socks_remote_dns`, `signon.autologin.proxy`, `network.proxy.socks_version`, `network.proxy.no_proxies_on`, `network.proxy.share_proxy_settings`, `network.proxy.http`, `network.proxy.http_port`, `network.proxy.ftp`, `network.proxy.ftp_port`, `network.proxy.ssl`, `network.proxy.ssl_port`, `network.proxy.socks`, `network.proxy.socks_port` +## Examples + + + ## Values - `Mode` is the proxy method being used. diff --git a/src/content/docs/reference/policies/RelaunchRequired.mdx b/src/content/docs/reference/policies/RelaunchRequired.mdx index ce5aa79..35dc1c6 100644 --- a/src/content/docs/reference/policies/RelaunchRequired.mdx +++ b/src/content/docs/reference/policies/RelaunchRequired.mdx @@ -4,6 +4,8 @@ description: "Require Firefox to be relaunched within a given period and notify category: "Device update settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -11,6 +13,10 @@ This policy takes effect when an update has been downloaded or staged and is rea **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values - `NotificationPeriodHours`: The minimum number of hours before users are notified of the required relaunch. diff --git a/src/content/docs/reference/policies/RequestedLocales.mdx b/src/content/docs/reference/policies/RequestedLocales.mdx index e8440ea..65a11da 100644 --- a/src/content/docs/reference/policies/RequestedLocales.mdx +++ b/src/content/docs/reference/policies/RequestedLocales.mdx @@ -4,6 +4,8 @@ description: "Set the the list of requested locales for the application in order category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set the the list of requested locales for the application in order of preference. It will cause the corresponding language pack to become active. @@ -13,6 +15,10 @@ It will cause the corresponding language pack to become active. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMax.mdx b/src/content/docs/reference/policies/SSLVersionMax.mdx index 93b9f85..c06f559 100644 --- a/src/content/docs/reference/policies/SSLVersionMax.mdx +++ b/src/content/docs/reference/policies/SSLVersionMax.mdx @@ -4,12 +4,18 @@ description: "Set and lock the maximum version of TLS." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set and lock the maximum version of TLS (Firefox defaults to a maximum of TLS 1.3). **Compatibility:** Firefox 66, Firefox ESR 60.6\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `security.tls.version.max` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SSLVersionMin.mdx b/src/content/docs/reference/policies/SSLVersionMin.mdx index 7cf49e0..437c1a6 100644 --- a/src/content/docs/reference/policies/SSLVersionMin.mdx +++ b/src/content/docs/reference/policies/SSLVersionMin.mdx @@ -4,12 +4,18 @@ description: "Set and lock the minimum version of TLS." category: "Network security" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set and lock the minimum version of TLS (Firefox defaults to a minimum of TLS 1.2). **Compatibility:** Firefox 66, Firefox ESR 60.6\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `security.tls.version.min` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx index 323e635..5fe3427 100644 --- a/src/content/docs/reference/policies/SanitizeOnShutdown.mdx +++ b/src/content/docs/reference/policies/SanitizeOnShutdown.mdx @@ -4,6 +4,8 @@ description: "Clear navigation data on shutdown." category: "Local data storage" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Clear local data on shutdown. `SanitizeOnShutdown` accepts either a boolean to clear all data types or an object to choose which data types to clear. Items that can be selectively deleted include browsing & download history, cookies, active logins, caches, form history, and site preferences. @@ -14,6 +16,10 @@ Items that can be selectively deleted include browsing & download history, cooki **CCK2 Equivalent:** N/A\ **Preferences Affected:** `privacy.sanitize.sanitizeOnShutdown`, `privacy.clearOnShutdown.cache`, `privacy.clearOnShutdown.cookies`, `privacy.clearOnShutdown.downloads`, `privacy.clearOnShutdown.formdata`, `privacy.clearOnShutdown.history`, `privacy.clearOnShutdown.sessions`, `privacy.clearOnShutdown.siteSettings`, `privacy.clearOnShutdown.offlineApps`, `privacy.clearOnShutdown_v2.browsingHistoryAndDownloads` (Firefox 128), `privacy.clearOnShutdown_v2.cookiesAndStorage` (Firefox 128), `privacy.clearOnShutdown_v2.cache` (Firefox 128), `privacy.clearOnShutdown_v2.siteSettings` (Firefox 128), `privacy.clearOnShutdown_v2.formdata` (Firefox 128) +## Examples + + + ## Values `SanitizeOnShutdown` accepts either a boolean or an object. diff --git a/src/content/docs/reference/policies/SearchBar.mdx b/src/content/docs/reference/policies/SearchBar.mdx index e96b470..d95c752 100644 --- a/src/content/docs/reference/policies/SearchBar.mdx +++ b/src/content/docs/reference/policies/SearchBar.mdx @@ -4,12 +4,18 @@ description: "Set whether or not search bar is displayed." category: "Search" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Set whether or not search bar is displayed. **Compatibility:** Firefox 60, Firefox ESR 60\ **CCK2 Equivalent:** `showSearchBar`\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SearchEngines.mdx b/src/content/docs/reference/policies/SearchEngines.mdx index 13739ef..e0fe1c2 100644 --- a/src/content/docs/reference/policies/SearchEngines.mdx +++ b/src/content/docs/reference/policies/SearchEngines.mdx @@ -4,12 +4,18 @@ description: "Configure search engines: add new ones, set defaults, prevent user category: "Search" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure search engines in Firefox. As of Firefox 139, these policies are available in all Firefox release channels. **Compatibility:** Firefox 139, Firefox ESR 60. `POST` support in Firefox ESR 68, `Encoding` in Firefox 91, `Remove` in Firefox ESR 60.2.\ **CCK2 Equivalent:** `searchplugins` (Add), `defaultSearchEngine` (Default), `disableSearchEngineInstall` (PreventInstalls), `removeDefaultSearchEngines` (Remove)\ **Preferences Affected:** N/A +## Examples + + + ## Values `SearchEngines` accepts an object with one or more of the following keys: diff --git a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx index 1e80858..1de57ae 100644 --- a/src/content/docs/reference/policies/SearchSuggestEnabled.mdx +++ b/src/content/docs/reference/policies/SearchSuggestEnabled.mdx @@ -4,12 +4,18 @@ description: "Enable search suggestions." category: "Search" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable search suggestions. **Compatibility:** Firefox 68, Firefox ESR 68\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.urlbar.suggest.searches`, `browser.search.suggest.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SecurityDevices.mdx b/src/content/docs/reference/policies/SecurityDevices.mdx index fd3be2f..07f0247 100644 --- a/src/content/docs/reference/policies/SecurityDevices.mdx +++ b/src/content/docs/reference/policies/SecurityDevices.mdx @@ -4,12 +4,18 @@ description: "Add or delete PKCS #11 modules." category: "Certificate management" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Add or delete PKCS #11 modules. **Compatibility:** Firefox 114, Firefox ESR 112.12\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/ShowHomeButton.mdx b/src/content/docs/reference/policies/ShowHomeButton.mdx index d779de5..7d26c7e 100644 --- a/src/content/docs/reference/policies/ShowHomeButton.mdx +++ b/src/content/docs/reference/policies/ShowHomeButton.mdx @@ -4,6 +4,8 @@ description: "Show the home button on the toolbar." category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Show the home button on the toolbar. Future versions of Firefox will not show the home button by default. @@ -12,6 +14,10 @@ Future versions of Firefox will not show the home button by default. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SitePolicies.mdx b/src/content/docs/reference/policies/SitePolicies.mdx index 51ff363..c335f71 100644 --- a/src/content/docs/reference/policies/SitePolicies.mdx +++ b/src/content/docs/reference/policies/SitePolicies.mdx @@ -4,6 +4,8 @@ description: "Fine grained control over policies for specific sites." category: "Browsing restrictions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Defines policies scoped to specific sites. **Compatibility:** Firefox 150, Firefox ESR 153\ @@ -47,6 +49,10 @@ While this setting would disable the JIT on every site except `*.example.org`: ] ``` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SkipTermsOfUse.mdx b/src/content/docs/reference/policies/SkipTermsOfUse.mdx index 19f9065..16b84f9 100644 --- a/src/content/docs/reference/policies/SkipTermsOfUse.mdx +++ b/src/content/docs/reference/policies/SkipTermsOfUse.mdx @@ -4,6 +4,8 @@ description: "Configure display settings for the Firefox Terms of Use and Privac category: "Startup" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Configure display settings for the Firefox Terms of Use and Privacy Notice on startup. 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. @@ -13,6 +15,10 @@ You represent that you accept and have the authority to accept the Terms of Use **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx index 8bb9c26..04bddef 100644 --- a/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx +++ b/src/content/docs/reference/policies/StartDownloadsInTempDirectory.mdx @@ -4,12 +4,18 @@ description: "Force downloads to start off in a local, temporary location rather category: "Downloads" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Force downloads to start off in a local, temporary location rather than the default download directory. **Compatibility:** Firefox 102\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.download.start_downloads_in_tmp_dir` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/SupportMenu.mdx b/src/content/docs/reference/policies/SupportMenu.mdx index d260f1c..9635dbf 100644 --- a/src/content/docs/reference/policies/SupportMenu.mdx +++ b/src/content/docs/reference/policies/SupportMenu.mdx @@ -4,12 +4,18 @@ description: "Add a menuitem to the help menu for specifying support information category: "Browser UI" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Add a menuitem to the help menu for specifying support information. **Compatibility:** Firefox 68.0.1, Firefox ESR 68.0.1\ **CCK2 Equivalent:** helpMenu\ **Preferences Affected:** N/A +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/Sync.mdx b/src/content/docs/reference/policies/Sync.mdx index 3ea7b34..0777b4a 100644 --- a/src/content/docs/reference/policies/Sync.mdx +++ b/src/content/docs/reference/policies/Sync.mdx @@ -4,6 +4,8 @@ description: "Enable or disable sync and define which data to include." category: "Local data storage" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Controls whether [sync](https://www.firefox.com/en-US/features/sync/) should be enabled and which features should be enabled for syncing. > [!NOTE] @@ -13,6 +15,10 @@ Controls whether [sync](https://www.firefox.com/en-US/features/sync/) should be **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values - `Addons`: A Boolean. Controls whether syncing addons should be enabled. diff --git a/src/content/docs/reference/policies/TranslateEnabled.mdx b/src/content/docs/reference/policies/TranslateEnabled.mdx index 28d3f10..5365092 100644 --- a/src/content/docs/reference/policies/TranslateEnabled.mdx +++ b/src/content/docs/reference/policies/TranslateEnabled.mdx @@ -4,6 +4,8 @@ description: "Enable or disable webpage translation." category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Enable or disable webpage translation. > [!NOTE] Web page translation is performed entirely client-side, so there is no data or privacy risk transmitting content to a translation service over the network. @@ -14,6 +16,10 @@ If you only want to disable the popup, you can set the `browser.translations.aut **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.translations.enable` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx index fa47b31..d934e8e 100644 --- a/src/content/docs/reference/policies/UseSystemPrintDialog.mdx +++ b/src/content/docs/reference/policies/UseSystemPrintDialog.mdx @@ -4,12 +4,18 @@ description: "Use the system print dialog instead of the print preview window." category: "Printing" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Use the system print dialog instead of the print preview window. **Compatibility:** Firefox 102\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `print.prefer_system_dialog` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/UserMessaging.mdx b/src/content/docs/reference/policies/UserMessaging.mdx index 97a9c9c..3d3427f 100644 --- a/src/content/docs/reference/policies/UserMessaging.mdx +++ b/src/content/docs/reference/policies/UserMessaging.mdx @@ -4,12 +4,18 @@ description: "Prevent Firefox from messaging the user in certain situations." category: "Miscellaneous" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Prevent Firefox from messaging the user in certain situations. **Compatibility:** Firefox 75, Firefox ESR 68.7\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.addons`, `browser.newtabpage.activity-stream.asrouter.userprefs.cfr.features`, `browser.aboutwelcome.enabled`, `browser.preferences.moreFromMozilla`, `browser.preferences.experimental` +## Examples + + + ## Values - `WhatsNew`: Remove the "What's New" icon and menuitem. (_Deprecated_) diff --git a/src/content/docs/reference/policies/VisualSearchEnabled.mdx b/src/content/docs/reference/policies/VisualSearchEnabled.mdx index a9087ce..f88d5cc 100644 --- a/src/content/docs/reference/policies/VisualSearchEnabled.mdx +++ b/src/content/docs/reference/policies/VisualSearchEnabled.mdx @@ -4,10 +4,16 @@ description: "Enable or disable visual search." category: "Search" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + **Compatibility:** Firefox 144\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `browser.search.visualSearch.featureGate` +## Examples + + + ## Windows (GPO) ```url diff --git a/src/content/docs/reference/policies/WebsiteFilter.mdx b/src/content/docs/reference/policies/WebsiteFilter.mdx index 7f61ef9..ef2b74d 100644 --- a/src/content/docs/reference/policies/WebsiteFilter.mdx +++ b/src/content/docs/reference/policies/WebsiteFilter.mdx @@ -4,6 +4,8 @@ description: "Block websites from being visited." category: "Browsing restrictions" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + Block websites from being visited. As of Firefox 83 and Firefox ESR 78.5, `file:` URLs are supported. @@ -11,6 +13,10 @@ As of Firefox 83 and Firefox ESR 78.5, `file:` URLs are supported. **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A +## Examples + + + ## Values `WebsiteFilter` expects an array of Match Patterns, as described in https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Match_patterns. diff --git a/src/content/docs/reference/policies/WindowsSSO.mdx b/src/content/docs/reference/policies/WindowsSSO.mdx index 926f73f..1e60cc4 100644 --- a/src/content/docs/reference/policies/WindowsSSO.mdx +++ b/src/content/docs/reference/policies/WindowsSSO.mdx @@ -4,6 +4,8 @@ description: "Allow Windows single sign-on for Microsoft, work, and school accou category: "Authentication" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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. @@ -12,6 +14,10 @@ If this policy is set to `true`, Firefox will use credentials stored in Windows **CCK2 Equivalent:** N/A\ **Preferences Affected:** `network.http.windows-sso.enabled` +## Examples + + + ## Windows (GPO) ``` diff --git a/src/content/docs/reference/policies/XSLTEnabled.mdx b/src/content/docs/reference/policies/XSLTEnabled.mdx index 174ef6f..fa33a67 100644 --- a/src/content/docs/reference/policies/XSLTEnabled.mdx +++ b/src/content/docs/reference/policies/XSLTEnabled.mdx @@ -4,12 +4,18 @@ description: "Enable or disable support for the XSLTProcessor JavaScript API and category: "Content settings" --- +import PolicyExample from "../../../../components/PolicyExample.astro"; + 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). **Compatibility:** Firefox 151\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** `dom.xslt.enabled` +## Examples + + + ## Windows (GPO) ``` From 82b246924cf79f0d83fdf44cddbb82658f9fe24d Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 15 Jun 2026 14:36:39 +0200 Subject: [PATCH 2/3] feat: Add examples sourced from schema --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c7dcb0b..2e109f9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,7 @@ Use the following sections per release and omit any that don't apply: - `### Fixed`: bug fixes, or corrections to documentation - `### Removed`: removed policies or deprecated functionality -### Examples +## Examples The following entry is for Firefox release version 119: From 234df9ec56e3885731b1bb32b8c824637c4e8636 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Mon, 15 Jun 2026 14:37:00 +0200 Subject: [PATCH 3/3] feat: Add examples sourced from schema --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 2e109f9..7089004 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -28,7 +28,7 @@ Use the following sections per release and omit any that don't apply: - `### Fixed`: bug fixes, or corrections to documentation - `### Removed`: removed policies or deprecated functionality -## Examples +### Example The following entry is for Firefox release version 119: