diff --git a/docs/src/api/class-clock.md b/docs/src/api/class-clock.md
index f2ee2433b4..4e3db3362b 100644
--- a/docs/src/api/class-clock.md
+++ b/docs/src/api/class-clock.md
@@ -249,7 +249,7 @@ Time to be set.
 ## async method: Clock.setSystemTime
 * since: v1.45
 
-Sets current system time but does not trigger any timers.
+Sets current system time without pausing, but does not trigger any timers. You most likely don't need this.
 
 **Usage**
 
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 1f165c3d93..504c14e01c 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -18555,7 +18555,7 @@ export interface Clock {
   setFixedTime(time: number|string|Date): Promise<void>;
 
   /**
-   * Sets current system time but does not trigger any timers.
+   * Sets current system time without pausing, but does not trigger any timers. You most likely don't need this.
    *
    * **Usage**
    *