diff --git a/webextensions/api/publicSuffix.json b/webextensions/api/publicSuffix.json
new file mode 100644
index 00000000000000..b29576d0836e8d
--- /dev/null
+++ b/webextensions/api/publicSuffix.json
@@ -0,0 +1,102 @@
+{
+  "webextensions": {
+    "api": {
+      "publicSuffix": {
+        "__compat": {
+          "support": {
+            "chrome": {
+              "version_added": false,
+              "impl_url": "https://crbug.com/40740063"
+            },
+            "edge": "mirror",
+            "firefox": {
+              "version_added": "153"
+            },
+            "firefox_android": "mirror",
+            "opera": "mirror",
+            "safari": {
+              "version_added": false
+            },
+            "safari_ios": "mirror"
+          }
+        },
+        "DomainEncoding": {
+          "__compat": {
+            "support": {
+              "chrome": {
+                "version_added": false
+              },
+              "edge": "mirror",
+              "firefox": {
+                "version_added": "153"
+              },
+              "firefox_android": "mirror",
+              "opera": "mirror",
+              "safari": {
+                "version_added": false
+              },
+              "safari_ios": "mirror"
+            }
+          }
+        },
+        "getDomain": {
+          "__compat": {
+            "support": {
+              "chrome": {
+                "version_added": false
+              },
+              "edge": "mirror",
+              "firefox": {
+                "version_added": "153"
+              },
+              "firefox_android": "mirror",
+              "opera": "mirror",
+              "safari": {
+                "version_added": false
+              },
+              "safari_ios": "mirror"
+            }
+          }
+        },
+        "getKnownSuffix": {
+          "__compat": {
+            "support": {
+              "chrome": {
+                "version_added": false
+              },
+              "edge": "mirror",
+              "firefox": {
+                "version_added": "153"
+              },
+              "firefox_android": "mirror",
+              "opera": "mirror",
+              "safari": {
+                "version_added": false
+              },
+              "safari_ios": "mirror"
+            }
+          }
+        },
+        "isKnownSuffix": {
+          "__compat": {
+            "support": {
+              "chrome": {
+                "version_added": false
+              },
+              "edge": "mirror",
+              "firefox": {
+                "version_added": "153"
+              },
+              "firefox_android": "mirror",
+              "opera": "mirror",
+              "safari": {
+                "version_added": false
+              },
+              "safari_ios": "mirror"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/webextensions/manifest/optional_permissions.json b/webextensions/manifest/optional_permissions.json
index 2ef78744680601..7627b1572890cd 100644
--- a/webextensions/manifest/optional_permissions.json
+++ b/webextensions/manifest/optional_permissions.json
@@ -654,6 +654,27 @@
             }
           }
         },
+        "publicSuffix": {
+          "__compat": {
+            "support": {
+              "chrome": {
+                "version_added": false,
+                "impl_url": "https://crbug.com/40740063"
+              },
+              "edge": "mirror",
+              "firefox": {
+                "version_added": "153",
+                "notes": "This permission is granted silently, without a user prompt."
+              },
+              "firefox_android": "mirror",
+              "opera": "mirror",
+              "safari": {
+                "version_added": false
+              },
+              "safari_ios": "mirror"
+            }
+          }
+        },
         "scripting": {
           "__compat": {
             "support": {