diff --git a/docs/src/browsers.md b/docs/src/browsers.md
index 83ea0f60c30e1..90c0b2850b415 100644
--- a/docs/src/browsers.md
+++ b/docs/src/browsers.md
@@ -342,7 +342,7 @@ Playwright ships a regular Chromium build for headed operations and a separate [
 
 #### Optimize download size on CI
 
-If you are only running tests in headless mode, for example on CI, you can avoid downloading a regular version of Chromium by passing `--only-shell` during installation.
+If you are only running tests in headless shell (i.e. the `channel` option is not specified), for example on CI, you can avoid downloading the full Chromium browser by passing `--only-shell` during installation.
 
 ```bash js
 # only running tests headlessly