diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md
index 709c78db7f..7621c017cd 100644
--- a/docs/src/api/class-browsercontext.md
+++ b/docs/src/api/class-browsercontext.md
@@ -1093,7 +1093,7 @@ Defaults to abort.
 * since: v1.23
 - `update` ?<boolean>
 
-If specified, updates the given HAR with the actual network information instead of serving from file.
+If specified, updates the given HAR with the actual network information instead of serving from file. The file is written to disk when [`method: BrowserContext.close`] is called.
 
 ### option: BrowserContext.routeFromHAR.url
 * since: v1.23
diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md
index 9fb1e5cddf..8a55560d51 100644
--- a/docs/src/api/class-page.md
+++ b/docs/src/api/class-page.md
@@ -3120,7 +3120,7 @@ Defaults to abort.
 * since: v1.23
 - `update` ?<boolean>
 
-If specified, updates the given HAR with the actual network information instead of serving from file.
+If specified, updates the given HAR with the actual network information instead of serving from file. The file is written to disk when [`method: BrowserContext.close`] is called.
 
 ### option: Page.routeFromHAR.url
 * since: v1.23
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index f7fb6d91e1..2951d77dd1 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -3359,7 +3359,9 @@ export interface Page {
     notFound?: "abort"|"fallback";
 
     /**
-     * If specified, updates the given HAR with the actual network information instead of serving from file.
+     * If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+     * written to disk when
+     * [browserContext.close()](https://playwright.dev/docs/api/class-browsercontext#browser-context-close) is called.
      */
     update?: boolean;
 
@@ -7478,7 +7480,9 @@ export interface BrowserContext {
     notFound?: "abort"|"fallback";
 
     /**
-     * If specified, updates the given HAR with the actual network information instead of serving from file.
+     * If specified, updates the given HAR with the actual network information instead of serving from file. The file is
+     * written to disk when
+     * [browserContext.close()](https://playwright.dev/docs/api/class-browsercontext#browser-context-close) is called.
      */
     update?: boolean;