diff --git a/docs/src/api/class-clock.md b/docs/src/api/class-clock.md
index 4e3db3362b..bca36682ce 100644
--- a/docs/src/api/class-clock.md
+++ b/docs/src/api/class-clock.md
@@ -249,7 +249,9 @@ Time to be set.
 ## async method: Clock.setSystemTime
 * since: v1.45
 
-Sets current system time without pausing, but does not trigger any timers. You most likely don't need this.
+Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for example switching from summer to winter time, or changing time zones.
+
+Don't use together with [`method: Clock.install`]. Read docs on [clock emulation](../clock.md) to learn more.
 
 **Usage**
 
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 504c14e01c..97fd5c0044 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -18555,7 +18555,11 @@ export interface Clock {
   setFixedTime(time: number|string|Date): Promise<void>;
 
   /**
-   * Sets current system time without pausing, but does not trigger any timers. You most likely don't need this.
+   * Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for
+   * example switching from summer to winter time, or changing time zones.
+   *
+   * Don't use together with [clock.install([options])](https://playwright.dev/docs/api/class-clock#clock-install). Read
+   * docs on [clock emulation](https://playwright.dev/docs/clock) to learn more.
    *
    * **Usage**
    *