ManagedBookmarks

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.

The syntax of this policy is based on the Chrome ManagedBookmarks policy, with the addition of the Firefox-specific favicon property.

Values

The first entry in the list names the toolbar folder, and the entries after it are the bookmarks:

toplevel_name: The name of the folder button added to the bookmarks toolbar. Only used in the first entry.
name: The name shown for a bookmark or folder.
url: The address the bookmark opens. A javascript: URL creates a bookmarklet.
favicon: The URL of an icon to show for the bookmark. Must be a data:, http: or https: URL.
children: A list of bookmarks to put in a folder. Folders can be nested.

Examples

{
  "policies": {
    "ManagedBookmarks": [
      {
        "toplevel_name": "My managed bookmarks folder"
      },
      {
        "url": "example.com",
        "name": "Example"
      },
      {
        "name": "Mozilla links",
        "children": [
          {
            "url": "https://mozilla.org",
            "name": "Mozilla.org"
          },
          {
            "url": "https://support.mozilla.org/",
            "name": "SUMO"
          }
        ]
      }
    ]
  }
}

JSON schema

{
  "items": {
    "properties": {
      "children": {
        "items": {
          "properties": {
            "favicon": {
              "type": "string",
              "format": "moz-url"
            },
            "name": {
              "type": "string"
            },
            "toplevel_name": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "children": {
              "items": {
                "type": [
                  "object",
                  "array"
                ],
                "contentMediaType": "application/json"
              },
              "type": "array"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "favicon": {
        "type": "string",
        "format": "moz-url"
      },
      "name": {
        "type": "string"
      },
      "toplevel_name": {
        "type": "string"
      },
      "url": {
        "type": "string"
      }
    },
    "type": "object"
  },
  "type": "array",
  "contentMediaType": "application/json"
}

Windows (GPO)

Software\Policies\Mozilla\Firefox\ManagedBookmarks (REG_MULTI_SZ) =

[
  {
    "toplevel_name": "My managed bookmarks folder"
  },
  {
    "url": "example.com",
    "name": "Example",
    "favicon": "https://example.com/favicon.ico"
  },
  {
    "name": "Mozilla links",
    "children": [
      {
        "url": "https://mozilla.org",
        "name": "Mozilla.org"
      },
      {
        "url": "https://support.mozilla.org/",
        "name": "SUMO"
      }
    ]
  }
]

macOS

<dict>
  <key>ManagedBookmarks</key>
  <array>
    <dict>
      <key>toplevel_name</key>
      <string>My managed bookmarks folder</string>
      <dict>
        <key>url</key>
        <string>example.com</string>
        <key>name</key>
        <string>Example</string>
        <key>favicon</key>
        <string>https://example.com/favicon.ico</string>
      </dict>
      <dict>
      <key>name</key>
      <string>Mozilla links</string>
      <key>children</key>
      <array>
        <dict>
          <key>url</key>
          <string>https://mozilla.org</string>
          <key>name</key>
          <string>Mozilla</string>
        </dict>
        <dict>
          <key>url</key>
          <string>https://support.mozilla.org/</string>
          <key>name</key>
          <string>SUMO</string>
        </dict>
      </array>
    </dict>
  </array>
</dict>

Compatibility

	Firefox	Firefox ESR	Firefox Enterprise
`ManagedBookmarks`	Available since 83	Available since 78.5	Available since 149
`url`¹	Available since 83	Available since 78.5	Available since 149
`favicon`	Available since 152	Available since 153	Available since 152

javascript: URLs are accepted from Firefox 153.

CCK2 Equivalent: N/A
OMA-URI: ManagedBookmarks
Preferences Affected: N/A