diff --git a/docs/src/api/params.md b/docs/src/api/params.md
index 92d046c482..04dc56e965 100644
--- a/docs/src/api/params.md
+++ b/docs/src/api/params.md
@@ -259,13 +259,13 @@ Specify environment variables that will be visible to the browser. Defaults to `
     - `httpOnly` <[boolean]>
     - `secure` <[boolean]>
     - `sameSite` <[SameSiteAttribute]<"Strict"|"Lax"|"None">> sameSite flag
-  - `origins` <[Array]<[Object]>> localStorage to set for context
+  - `origins` <[Array]<[Object]>>
     - `origin` <[string]>
-    - `localStorage` <[Array]<[Object]>>
+    - `localStorage` <[Array]<[Object]>> localStorage to set for context
       - `name` <[string]>
       - `value` <[string]>
     - `indexedDB` ?<[Array]<[Object]>>
-      - `name` <[string]>
+      - `name` <[string]> TODO: document more
 
 Learn more about [storage state and auth](../auth.md).
 
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 14725e558a..5e09d4ac46 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -10049,12 +10049,12 @@ export interface Browser {
         sameSite: "Strict"|"Lax"|"None";
       }>;
 
-      /**
-       * localStorage to set for context
-       */
       origins: Array<{
         origin: string;
 
+        /**
+         * localStorage to set for context
+         */
         localStorage: Array<{
           name: string;
 
@@ -10062,6 +10062,9 @@ export interface Browser {
         }>;
 
         indexedDB?: Array<{
+          /**
+           * TODO: document more
+           */
           name: string;
         }>;
       }>;
@@ -22220,12 +22223,12 @@ export interface BrowserContextOptions {
       sameSite: "Strict"|"Lax"|"None";
     }>;
 
-    /**
-     * localStorage to set for context
-     */
     origins: Array<{
       origin: string;
 
+      /**
+       * localStorage to set for context
+       */
       localStorage: Array<{
         name: string;
 
@@ -22233,6 +22236,9 @@ export interface BrowserContextOptions {
       }>;
 
       indexedDB?: Array<{
+        /**
+         * TODO: document more
+         */
         name: string;
       }>;
     }>;