diff --git a/docs/src/test-reporter-api/class-reporter.md b/docs/src/test-reporter-api/class-reporter.md
index ef16d278b7..38b28f9e49 100644
--- a/docs/src/test-reporter-api/class-reporter.md
+++ b/docs/src/test-reporter-api/class-reporter.md
@@ -90,6 +90,8 @@ Here is a typical order of reporter calls:
 Additionally, [`method: Reporter.onStdOut`] and [`method: Reporter.onStdErr`] are called when standard output is produced in the worker process, possibly during a test execution,
 and [`method: Reporter.onError`] is called when something went wrong outside of the test execution.
 
+If your custom reporter does not print anything to the terminal, implement [`method: Reporter.printsToStdio`] and return `false`. This way, Playwright will use one of the standard terminal reporters in addition to your custom reporter to enhance user experience.
+
 ## optional method: Reporter.onBegin
 * since: v1.10
 
@@ -273,4 +275,4 @@ Result of the test run.
 * since: v1.10
 - returns: <[boolean]>
 
-Whether this reporter uses stdio for reporting. When it does not, Playwright Test could add some output to enhance user experience.
+Whether this reporter uses stdio for reporting. When it does not, Playwright Test could add some output to enhance user experience. If your reporter does not print to the terminal, it is strongly recommended to return `false`.
diff --git a/packages/playwright-test/types/testReporter.d.ts b/packages/playwright-test/types/testReporter.d.ts
index c905d6157c..76af5e52b1 100644
--- a/packages/playwright-test/types/testReporter.d.ts
+++ b/packages/playwright-test/types/testReporter.d.ts
@@ -367,6 +367,11 @@ export interface FullResult {
  * called when standard output is produced in the worker process, possibly during a test execution, and
  * [reporter.onError(error)](https://playwright.dev/docs/api/class-reporter#reporter-on-error) is called when
  * something went wrong outside of the test execution.
+ *
+ * If your custom reporter does not print anything to the terminal, implement
+ * [reporter.printsToStdio()](https://playwright.dev/docs/api/class-reporter#reporter-prints-to-stdio) and return
+ * `false`. This way, Playwright will use one of the standard terminal reporters in addition to your custom reporter
+ * to enhance user experience.
  */
 export interface Reporter {
   /**
@@ -441,7 +446,7 @@ export interface Reporter {
 
   /**
    * Whether this reporter uses stdio for reporting. When it does not, Playwright Test could add some output to enhance
-   * user experience.
+   * user experience. If your reporter does not print to the terminal, it is strongly recommended to return `false`.
    */
   printsToStdio?(): boolean;}