Skip to content

feat: Update examples following schema sync #252

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bsmth merged 1 commit into from
Jul 31, 2026
Merged

feat: Update examples following schema sync #252

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 0 additions & 23 deletions src/content/docs/reference/policies/AutoLaunchProtocolsFromOrigins.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 1 addition & 7 deletions src/content/docs/reference/policies/DisableThirdPartyModuleBlocking.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,7 @@ This policy only works on Windows through GPO, not via `policies.json`.

## Examples

```json
{
"policies": {
"DisableThirdPartyModuleBlocking": true
}
}
```
<PolicyExample policy="DisableThirdPartyModuleBlocking" />

## Windows (GPO)

Expand Down
8 changes: 1 addition & 7 deletions src/content/docs/reference/policies/DownloadDirectory.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,7 @@ You can use `${home}` for the native home directory.

## Examples

```json
{
"policies": {
"DownloadDirectory": "${home}/Downloads"
}
}
```
<PolicyExample policy="DownloadDirectory" />

## Windows (GPO)

Expand Down
35 changes: 26 additions & 9 deletions src/content/docs/reference/policies/EnterprisePoliciesEnabled.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -28,3 +28,20 @@ Enable policy support on macOS.
<true/>
</dict>
```

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
31 changes: 0 additions & 31 deletions src/content/docs/reference/policies/ManagedBookmarks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down