diff --git a/docs/src/api/class-android.md b/docs/src/api/class-android.md
index f5ea2de8a5..3a30fc4108 100644
--- a/docs/src/api/class-android.md
+++ b/docs/src/api/class-android.md
@@ -3,6 +3,21 @@
 
 Playwright has **experimental** support for Android automation. See [here](./mobile.md) for more information. You can access android namespace via:
 
+*Requirements*
+
+* Android device or AVD Emulator.
+* [ADB daemon](https://developer.android.com/studio/command-line/adb) running and authenticated with your device. Typically running `adb devices` is all you need to do.
+* [`Chrome 87`](https://play.google.com/store/apps/details?id=com.android.chrome) or newer installed on the device
+* "Enable command line on non-rooted devices" enabled in `chrome://flags`.
+
+*Known limitations*
+
+* Raw USB operation is not yet supported, so you need ADB.
+* Device needs to be awake to produce screenshots. Enabling "Stay awake" developer mode will help.
+* We didn't run all the tests against the device, so not everything works.
+
+*How to run*
+
 ```js
 const { _android: android } = require('playwright');
 ```
diff --git a/types/types.d.ts b/types/types.d.ts
index 046f065fe8..d40a0a2f5f 100644
--- a/types/types.d.ts
+++ b/types/types.d.ts
@@ -9158,6 +9158,20 @@ export {};
  * Playwright has **experimental** support for Android automation. See [here](https://playwright.dev/docs/mobile) for more information. You can
  * access android namespace via:
  *
+ * *Requirements*
+ * - Android device or AVD Emulator.
+ * - [ADB daemon](https://developer.android.com/studio/command-line/adb) running and authenticated with your device.
+ *   Typically running `adb devices` is all you need to do.
+ * - [`Chrome 87`](https://play.google.com/store/apps/details?id=com.android.chrome) or newer installed on the device
+ * - "Enable command line on non-rooted devices" enabled in `chrome://flags`.
+ *
+ * *Known limitations*
+ * - Raw USB operation is not yet supported, so you need ADB.
+ * - Device needs to be awake to produce screenshots. Enabling "Stay awake" developer mode will help.
+ * - We didn't run all the tests against the device, so not everything works.
+ *
+ * *How to run*
+ *
  * ```js
  * const { _android: android } = require('playwright');
  * ```