docs: Update permissions section with per-browser warning (#2284)

2026-04-18 09:08:09 -05:00
parent 54fe8c6687
commit e802aa211f
1 changed files with 17 additions and 0 deletions
@@ -200,6 +200,23 @@ export default defineConfig({
 });
 ```

+:::warning
+
+Different browsers support different permissions. You are responsible for passing only the permissions required for each browser:
+
+```ts
+export default defineConfig({
+  manifest: ({ browser }) => ({
+    permissions:
+      browser === 'chrome'
+        ? ['storage', 'favicon', 'declarativeNetRequest']
+        : ['storage', 'webRequest'],
+  }),
+});
+```
+
+:::
+
 ## Host Permissions

 > [Chrome docs](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions#host-permissions)