diff --git a/docs/guides/guides/module-api.mdx b/docs/guides/guides/module-api.mdx
index 567f38f8be..fdd143af3c 100644
--- a/docs/guides/guides/module-api.mdx
+++ b/docs/guides/guides/module-api.mdx
@@ -10,6 +10,17 @@ results directly after the run. With this workflow, for example, you can:
 - Rerun a single failing spec file
 - Kick off other builds or scripts
 
+:::info
+
+<strong>Yarn Plug'n'Play</strong>
+
+To run Cypress via Node.js in a
+[Yarn Plug'n'Play](https://yarnpkg.com/features/pnp) environment, use
+[yarn node](https://yarnpkg.com/cli/node) instead of
+[node](https://nodejs.dev/en/learn/run-nodejs-scripts-from-the-command-line/).
+
+:::
+
 ## `cypress.run()`
 
 Runs Cypress tests via Node.js and resolve with all test results. See the