From 34aaed34150327e6393c22451890e774eb0e1d44 Mon Sep 17 00:00:00 2001
From: Michael Kaply <345868+mkaply@users.noreply.github.com>
Date: Mon, 15 Jun 2026 14:25:18 -0400
Subject: [PATCH] Add documentaton for ManagedBookmarks->favicon. Fixes #189

---
 .../reference/policies/ManagedBookmarks.mdx    | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/src/content/docs/reference/policies/ManagedBookmarks.mdx b/src/content/docs/reference/policies/ManagedBookmarks.mdx
index d19f3f7..fec8eb3 100644
--- a/src/content/docs/reference/policies/ManagedBookmarks.mdx
+++ b/src/content/docs/reference/policies/ManagedBookmarks.mdx
@@ -8,7 +8,7 @@ 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 exactly the same as the [Chrome ManagedBookmarks policy](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ManagedBookmarks).
+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
@@ -22,6 +22,9 @@ The schema is:
         },
         "type": "array"
       },
+      "favicon": {
+        "type": "string"
+      },
       "name": {
         "type": "string"
       },
@@ -38,6 +41,8 @@ The schema is:
 }
 ```
 
+A `favicon` can be specified for each bookmark. The value must be a `data:`, `http:`, or `https:` URL. (Added in Firefox 152)
+
 **Compatibility:** Firefox 83, Firefox ESR 78.5\
 **CCK2 Equivalent:** N/A\
 **Preferences Affected:** N/A
@@ -53,7 +58,8 @@ Software\Policies\Mozilla\Firefox\ManagedBookmarks (REG_MULTI_SZ) =
   },
   {
     "url": "example.com",
-    "name": "Example"
+    "name": "Example",
+    "favicon": "https://example.com/favicon.ico"
   },
   {
     "name": "Mozilla links",
@@ -90,7 +96,8 @@ Value (string):
   },
   {
     "url": "example.com",
-    "name": "Example"
+    "name": "Example",
+    "favicon": "https://example.com/favicon.ico"
   },
   {
     "name": "Mozilla links",
@@ -138,6 +145,8 @@ Value (string):
         <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>
@@ -173,7 +182,8 @@ Value (string):
       },
       {
         "url": "example.com",
-        "name": "Example"
+        "name": "Example",
+        "favicon": "https://example.com/favicon.ico"
       },
       {
         "name": "Mozilla links",