From ec5dcacdab793f7fdec541fceecc5137bd10c3b2 Mon Sep 17 00:00:00 2001 From: Brian Smith Date: Fri, 31 Jul 2026 13:03:59 +0200 Subject: [PATCH] feat: Update examples following schema sync --- .../AutoLaunchProtocolsFromOrigins.mdx | 23 ------------ .../DisableThirdPartyModuleBlocking.mdx | 8 +---- .../reference/policies/DownloadDirectory.mdx | 8 +---- .../policies/EnterprisePoliciesEnabled.mdx | 35 ++++++++++++++----- .../reference/policies/ManagedBookmarks.mdx | 31 ---------------- 5 files changed, 28 insertions(+), 77 deletions(-) diff --git a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx index 5adbc8f..9b7cbc7 100644 --- a/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx +++ b/src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx @@ -9,29 +9,6 @@ Define a list of external protocols that can be used from listed origins without 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). This also means that you cannot specify a wildcard (`*`) for all origins. -The schema is: - -```json -{ - "items": { - "properties": { - "allowed_origins": { - "items": { - "type": "string" - }, - "type": "array" - }, - "protocol": { - "type": "string" - } - }, - "required": ["protocol", "allowed_origins"], - "type": "object" - }, - "type": "array" -} -``` - **Compatibility:** Firefox 90, Firefox ESR 78.12\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A diff --git a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx index 17a35a5..31f5ce0 100644 --- a/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx +++ b/src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx @@ -14,13 +14,7 @@ This policy only works on Windows through GPO, not via `policies.json`. ## Examples -```json -{ - "policies": { - "DisableThirdPartyModuleBlocking": true - } -} -``` + ## Windows (GPO) diff --git a/src/content/docs/reference/policies/DownloadDirectory.mdx b/src/content/docs/reference/policies/DownloadDirectory.mdx index 4869195..5997f71 100644 --- a/src/content/docs/reference/policies/DownloadDirectory.mdx +++ b/src/content/docs/reference/policies/DownloadDirectory.mdx @@ -13,13 +13,7 @@ You can use `${home}` for the native home directory. ## Examples -```json -{ - "policies": { - "DownloadDirectory": "${home}/Downloads" - } -} -``` + ## Windows (GPO) diff --git a/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx b/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx index 51d0215..9dae036 100644 --- a/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx +++ b/src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx @@ -6,19 +6,19 @@ category: "Miscellaneous" Enable policy support on macOS. +This turns on policy support **for macOS via plist**, rather than a policy that configures other browser behavior. +Until this policy is set, Firefox ignores every policy in the plist. +See [Configuring policies](/guides/policies-configuration/) for where each policy source lives. + **Compatibility:** Firefox 63, Firefox ESR 60.3 (macOS only)\ **CCK2 Equivalent:** N/A\ **Preferences Affected:** N/A -## Examples - -```json -{ - "policies": { - "EnterprisePoliciesEnabled": true - } -} -``` +> [!WARNING] +> +> - A `policies.json` file is read on macOS regardless of whether `EnterprisePoliciesEnabled` is set or not. +> - Setting `EnterprisePoliciesEnabled` in `policies.json` has no effect and is reported as an error in `about:policies`. +> For this reason, all non-macOS sections are omitted deliberately from this page. ## macOS @@ -28,3 +28,20 @@ Enable policy support on macOS. ``` + +To enable policies from the command line, set the key system-wide: + +```bash +sudo defaults write /Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE +``` + +Or, for the current user only, in `~/Library` without `sudo`: + +```bash +defaults write ~/Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE +``` + +## See also + +- [Configuring policies](/guides/policies-configuration/) +- [Manage policies on macOS desktops](https://support.mozilla.org/en-US/kb/managing-policies-macos-desktops) on SUMO diff --git a/src/content/docs/reference/policies/ManagedBookmarks.mdx b/src/content/docs/reference/policies/ManagedBookmarks.mdx index 9f09af7..a7e2a75 100644 --- a/src/content/docs/reference/policies/ManagedBookmarks.mdx +++ b/src/content/docs/reference/policies/ManagedBookmarks.mdx @@ -9,37 +9,6 @@ Configures a list of bookmarks managed by an administrator that cannot be change The bookmarks are only added as a button on the personal toolbar. They are not in the bookmarks folder. The syntax of this policy is based on the [Chrome ManagedBookmarks policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ManagedBookmarks), with the addition of the Firefox-specific `favicon` property. -The schema is: - -```json -{ - "items": { - "id": "BookmarkType", - "properties": { - "children": { - "items": { - "$ref": "BookmarkType" - }, - "type": "array" - }, - "favicon": { - "type": "string" - }, - "name": { - "type": "string" - }, - "toplevel_name": { - "type": "string" - }, - "url": { - "type": "string" - } - }, - "type": "object" - }, - "type": "array" -} -``` A `favicon` can be specified for each bookmark. The value must be a `data:`, `http:`, or `https:` URL. (Added in Firefox 152)